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SX-WINDOW の 本格的な 解析 資料と して 『SX-WINDOW プ ログ ラミン 
グ』、 『追 補 版 SX-WINDOW プログラミング』 が 刊行され たのが 1991 年。 
あれから 早く も 4 年の 歳月が 過ぎようと しています。 当時は まだ 実用 面で 不 
満な 部分 も あった SX-WINDOW も、 現在では 機能的に も 充実した ver.3.1 
がリ リースされ、 シャープからの 公式な 開発 資料と して 「SX-WINDOW 開 
発 キット Workroom  SX-68K」 が 発売され るな ど、 SX-WINDOW を 取り巻 
くが 況 は、 4 年 前と 比べて 飛躍的に 向上した といえるでしょう。 

しかしながら、 全国の SXer  (SX-WINDOW で プロ グラミ ングを 目指す 
人々 の 呼称） の 期待を 一身に 背負って 発売され た Workroom の 内容は、 3 年 
前の ver.2.0 相当の 情報を 公開す るに 留まり、 SX-WINDOW プ ログ ラミン 
グの開 発 環境は 時化 に 取り残された おとなって います。 

そのような 現状を 巧 破し、 追 補 版からの 空白の 時間を 埋め合わせ、 SX- 
WINDOW  ver.3.1 に 対応した 最新の 開発 環境を 提供す る とと もじ、 『SX- 
WINDOW プログラミング』、 『追 補 版 SX-WINDOW プログラミング』、 そ 
して Workroom  SX-68K と 分散 してし まった SX コ ー ル. リファレンスを 
1 つじ まとめ、 SX コールの 集大成と しても 機能す るよう にと 本書は 企画 さ 
れま した。 

本書は、 主に C 言語で SX-WINDOW アプリケーションを 開発す る 人を 
が 象と した プロ グラミ ング 入門、 提供 ライブ ラ リ などの 開発 環境の 使い方 
の 解説 か ら なる 第 1 部と、 ver.3.1 ま でが 応 した SX コ ー ルの 総 集 編で ある 
第 2 部から 構成され ます。 

大まかな 内容は 次の よう になって います。 

第 1 部  SX-WINDOW 開発 入門 

第 1 章 SX-WINDOW プ ログ ラミン グの 基礎 

これから SX-WINDOW での プロ グラミ ングを 始めよ うとい う 
人を が 象 じ、 その 基礎を おさらいし、 これまでの SX-WINDOW 
プロ グラミ ング 環境の 流れに ついて 解説し ます。 
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第 2 章 インスト ー ル 

添 か フロ ッ ピー ディ スク から 本書の 筆者たち が 推奨す る 開発 環境 
を インストール する 方法と、 添付 CD— 民 0M から SX-WINDOW 
用に 開発され たフ リー ソフトを インス トールす る 方法 じついて 
説明し ます。 

第 3 章 SX-WINDOW  ver.3.1 關発 キット 

Workroom を 基礎と して ver.3.1 対応を 斤った SX31KIT の 概説 
と、 SX31KIT による プロ グラミ ング、 callno  header の 使い 
方 じついて サンプルを まじえて 解説し ます。 その他、 ver.3.0 じ 
なって 新設され た マネージャの 機能と 簡単な 利用 方法を 紹介し 
ます。 

第 4 章  LIBSXC 

X680x0 の gcc で SX-WINDOW アプリ ケーシ ヨンの 開発を 斤 
う にあたって 必要 不可欠な ライブラリ である LIBSXC について 
詳説し ます。 

APPENDIX 

SX31KIT の 構造体の 詳細 や LIBSXC の 内部構造 などに ついて 中 
級 者の I 上向けに 解説して あり ます。 

さらに、 添 か CD-ROM に 収録 させて いただいた フ リー ソフト 
の 一覧を 備 単な 紹介と ともに 掲載して あり ます。 

第 2 部 SX コール •リファレンス 

SX-WINDOW  ver.3.1 じ 対応した 全 コール. リファレンスを 記載し 
ま した。 

添付 フロ ッ ピー ディスク 

本書で 提供す る 基本的な 開発 環境 （LIBSXC,  callno  header,  SX31 
KIT)、 なら びに 株式を 社 計測 お 研の ご 厚意に より CD-ROM ドライ 
バ (機能 限定 赋 を 収録 しました。 

インス トール および 収録 内容 じついての 詳細は 「2.1 添 か FD から 
の インスト ー ル」 （P.34) を ご 難く ださい。 


はじめに 


添付 CD-ROM 

大手 BBS である NIFTY-Serve と、 SX- WINDOW を 中' じ、 と した 
草の根 BBS である Network-SX  NG から 集めうる かぎりの SX- 
WINDOW フリーソフトと gcc や mule などの 開発 ツール ー式を 収 
録 しま した。 いずれも 秀作 ばかりを 贊 沢に 揃えました ので、 CD-ROM 
ドライブを 用意して ぜひ お楽しみく ださい。 また、 一部の フリー ソ 
フト につき ま しては 作者の ご 厚意に よって、 ソースファイル も 添付 
させて いただき ま した。 SX- WINDOW での アプリ ケー シヨ ンの 作成 
にお 役立てく ださい。 

なお、 収録 されて いる フリーソフト の一覽 について は APPENDIX  C 
章 「SX-WINDOW フリー ソフト ー覚」 （P.171) を、 インストー ルに 
ついての 詳細は 「2.2 添が CD-ROM からの イ ンス トール」 （P.51) を 
ご覚 ください。 

本書が SX-WINDOW 上に あなたの 窓を 開く 肋け となる ことを 祈って。 

1995 年 6 巧 吉日  ひそ やかに 梅雨の ふる 朝に 

著者 代表 牛 島 健 雄 
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SX— WINDOW  は  X680x0 シリ ー 
で 動作す る 疑似 マルチ タスク •ウィ 
ン ドウ システムです 0 本章では、 こ 
れ から SX— WINDOW の アプリ ケー 
シ ヨンの 開発を 始めよ うとい う 人の 
ためじ SX— WINDOW システム じつ 
いて 簡単な 解説を 巧い、 本 善で 推奨 
する アプリ ケ •"••シヨ ン 開発 環境 じつ 
いて 紹介し ます。 


Chapter 1 SX-WINDOW プログラミング のち 礎 


SX-WINDOW は、 X680x0 シリ ーズの OS  (オペレーティング シス テ 
ム、 基本 ソフ トウ ェア） である Human68k 上に 構築され た マルチ ウィン 
ドウ システム の 総称です。 イベント 駆動 型と 呼ばれ る 方式に よる 疑似 マ 
ル チ タスク 方式を 使って 複数の アプリ ケー ショ ンを 同時に 実 斤す る こと 
が 可能です。 

これらは 、ウィ ン ドウ 環境を 実現す るた めの 基本 サブルーチン 群を 提 
供す る ソフト ウ卫ア "FSX.X" と、 疑似 マルチ タスクに よる 動作 環境を 提 
供す るた めの ソフ トウ ェア "SXWIN.X" の 2 つから 構成され、 主に 前者が 
"SX システム"、 後者が" SX シェル" と 呼ばれて います。 

本節では、 SX- WINDOW の 動作の 仕組みと SX システム カぶ 提供す る 
サービス について 説明を 加えた あとで、 SX-WINDOW 上で 動作す るア 
プリ ケー ショ ン のすべき こと、 しては ならない ことにつ いて 述べます。 


SX-WINDOW 上で 実 斤され る 各々 の アプリ ケー ショ ンは それぞれが 
「タスク」 と 呼ばれ、 SX シ卫 ルに おける 化理 単位と して 他の 化理 とは 独 
立 かつ 並列 に 実行 されます。 

ここで SX-WINDOW で 採用され ている イ ベン ト 駆動 型と 呼ばれる 疑 
似 マルチ タスク 化理は どのような ものな のか 見て みまし ょう。 

マルチ タスク 化理の 基本は、 原理 的に 1 命令し か 実 斤で きない CPU に 
おいて、 ある タイミングで 化理を 切り替える ことにより、 個々 の 命令 レ 
ベルでは なく、 各タ スク の化理 レベルから 見た 場合に 複数の 化理を 同時 
じ 実 斤して いるかの よう に 見せる ことです。 

一般に マルチ タスクの 実現 方式は、 その タイミング のとり 方に よって 
。[下の 2 種類に 大別 されます。 

〇 タイム スライ シング 型 マルチ タスク 

〇 イベント 駆動 型 マルチ タスク 


1-1  SX— WINDOW  お 説 


前者の タイム スライ シン グ型 マルチ タスクは、 CPU の 動作を 短い 時間 
に 細かく 分割し、 それぞれの 時間を 複数の アプリ ケー ショ ンの 実行に 割 
り 当てる 方式です。 化理を 切り替える タイ ミ ングと して 時間を 用いた マ 
ル チ タスク 嫂理 方式です。 この 方式の 場合、 原則として それぞれの タス 
ク に 割り 当てられた 化理 時間 （ CPU 時間） は 一定な ので、 等 間隔で 実 斤 
する よう な 化理に は 好都合な も のの、 持ち時間が 過 ぎれば 現在の タスク 
が 終了 していな く て も 別の タスクに 化 理が切 り 替わって しまい ますし、 
逆に 持ち時間が 余っても 他の タスクに 切り替わる ことがない など、 CPU 
全体の 化理に 無駄が 出る ことがあります （Fig.  1-1)。 そのため、 化理 速度 
の 遅い CPU で 実現され る マルチ タスク システムには あま り 利用され ま 
せん。 


F お. 1-1 参 タイム スライ シング 型 マルチ タスクの か 作 


D 実 原の 処ミ里 時間 おな な 待ち時間 


後者の イベント 駆動 型 マルチ タスクは、 キーが 押された などの、 外部 
からの イ ベン ト に応じて タスクを 切り替える マルチ タスク 化理 方式です。 
この 方式では、 それぞれの タスクは 自分に 関わる イベントの 発生を つね 
じ 監視して おり、 それが 発生した 時点で 必要な 化理を 斤う ことじな るた 
め、 無駄な 時間を 截 すよう な タスク 化理を 未然に防ぐ ことができます。 
そのため、 比較的 嫂理 速度の 遅い CPU における マルチ タスク システム じ 
は 最適の 方式で あると されます。 しかし、 正確には 複数の タスクが 同時 
じ 実 斤され る わけでは ないた め、 「疑似 マルチ タスク」 と 呼ばれて います 
(Fig.  1-2)。 

SX- WINDOW  ver.1.0 が 発表され た 当時の X680x0 シリ ーズで 採用 さ 
れ ていた CPU は lOMHz の MC68000 という、 それほど 嫂理 速度の 速く 
ない CPU であった ことから、 SX-WINDOW がイ ベン ト 駆動 型の 疑似 マ 
ル チ タスク 方式を 採用した ことは 正しい 選キ 尺と いえ ま した。 

しかし、 ここで; 主意し なければ ならない 点が 1 つ あり ます。 

タイム スライ シング 型 マルチ タスク 方式では、 化 理の切 り 替えは マル 
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Chapter 1 SX- WINDOW プログラミングの 基礎 


F お. 1-2  ♦ イ ベン ト巧動 型 マルチ タスクの 動か 


S  X システム 

タスク 1 

タスク 2 


□ 


実際の 処理 時間 


□ 


システムの 空き時間 


チ タスク 動作を 実現す る システムが 自動的に 斤う のじ 対して、 イベント 
駆動 型 マルチ タスク 方式では、 タスクの 切り替え タイ ミ ングは 個々 の夕 
スクに 依存して いるた め、 イ ベン ト への 対応 化理は 比較的 短時間で すま 
さなければ ならない という ことです。 

つまり、 実際の 疑似 マルチ タスクの 動作と して、 タスクから タスクへ 
の 切り替えは、 タスクが イベントの 化理を 終了し、 イベント 待ちに 入っ 
た 時点で 斤 われます。 もし、 ある タスクが 受け取った イベントの 化理じ 
時間が かかって しまう と、 次に 化理 される 予定の タスクは 実 斤を 待た さ 
れる ことと なり、 システム 全体と しては マルチ タスクとは いえない よう 
な 動作に なって しまいます。 SX-WINDOW では、 システムの 状態が 変化 
する まで SX システムが ずっと 待機して いる ことは なく、 実際には その 
間に アイ ド ルイ ベン トが 発行され ます。 

このよう な こ とから、 イ ベン ト 駆動 型 マルチ タスク システムで 動作す 
る アプリ ケー ショ ン では 各々 の イベント に 対応す る 化理を 記述す る だけ 
でな く、 マルチ タスクを 実現す るた めの 作法に 則った 記述を 斤わなければ 
なりません。 アプリケーションを 記述す るう えでの 作法に ついては 「SX 
アプリ ケー ショ ンの 基礎」 （P.9) で 詳しく述べます。 

次に、 SX システムが 提供して く れる サービス について 解説し ます。 

(^SX システムが 提供ず る 甘 ー ビス) 


SX-WINDOW は Human68k の 上で 動作して い る こと はすで に 述べた 
とおり です が、 Human68k じは COMMAND .  X を はじめと する コマンド 化 
理 による 対話 型イ ン ター フェースの シェルし か 用意され て おらず、 SX- 
WINDOW  での ウイン ドウ や アイ コンと いった マウス オペレーションを 基 
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1-1  SX- WINDOW  概説 


本と した GUI  (グラフ イ カル- ユーザ •イ ン ター フュー ス） のた めの サー 
ビスは、 すべて SX システム じよって 提供され ています。 

これらの サービス 群は 「SX コール」 と 呼ばれ、 メモリ 管理、 イベント 
化理、 画面 表示 といった システム 内部で 用いられる ような 基本的な もの 
から、 ウィンドウ 揣 画、 メニュー 嫂理 などの 高度な ものまで 数多く 用意 
されて います。 SX コールには、 それぞれの 役割を もとにして、 メモリ 管 
理を 斤う のが メ モリ マン、 ウイン ドウの 描画は ウ インド ウマンと いうよ 
うじ、 「〜 マン」 という 名称で 呼ばれる、 全部で 21 種類の マネージャが 
存在し ます。 これら マネージャの 一覽を Table 1-1 に 示します。 


Table 1-1 •  SX システムの マネージ ヤー H 


マネージャ 名 

処理の 概要 

備考 

イ ベン ト マン 

イベント の 管理 

アニメ ー シヨ ン マン 

マウス ポイ ンタの アニメ ー シヨ ンの 管理 

コント ロ  ー ルマン 

ボタンな どの コント ロールの 管理 

ダイアログ マン 

ダイアログ ボッ クスの 作成 や 表示 

エ クセプ シヨ ン マン 

V-D に P 割り 込みの 管理 

グラフマン 

画面への 描画 

キーマン 

キ ーボー ド マンと イ ベン ト マンの 仲介 

キ ー ボ _ ド マン 

キー データの 管理 

メモリ マン 

メモリ の 管理 

メニュー マン 

メニ ューの 作成と 表示 

マウス マン 

マウスの 管理 

リ ソース マン 

り ソースの 管理 

タスク マン 

全 マネージャを 統す 舌し、 タスク 操作を 管理 

テキス ト マン 

文字列 や 文章の 編集 

ウイン ドウ マン 

ウィン ドウの 管理 

プリント マン 

が 刷 機能の 提供 

ver.1.1 より 追 カロ 

サブ ウイン ドウ マン 

サブ ウィン ドウの 管理 

ver.1.1 より 追 カロ 

フォン ト マン 

フォン トの 管理 

ver.2.0 より 追 カロ 

カ ラー マン 

カラー 情報の 管理 

ver.3.0 より 追 カロ 

ビデオ マン 

映像 再生 機能の 提供 

ver.3.0 より 追 カロ 

セ マフ ォ マン 

セマフォの 管理 

ver.3.0 より 追 カロ 

個々 の マネージャの 詳細に ついては、 『SX- WINDOW プロ グラミ ング』 
似 下、 SX 本と 呼ぶ） ならびに 『追 補 版 SX-WINDOW プログラミング』 
似 下、 追 補 版と 呼ぶ。 いずれ も ソフトバンク 刊)、 『Workroom  SX-68K プ 
ログ ラマーズ マニュアル』 （シャープ） などを 参照して いただく と して、 
ここでは 説明を 省略 させて いただきます （SX-WINDOW  ver.3.0 で 新た 
じ 追加され た、 カラー マン、 ビデオ マンに ついては 「3.2  SX-WINDOW 
ver. 义 1 環境での プロ グ ラミン グ 例」 （P.92) な どで 取り 上げて いま すので、 
そちらを 参照して く ださい)。 

SX-WINDOW における SX コー ルは、 Human68k における DOS コー 
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ルに あたる ものです が、 両者には 決定的な 違いが あり ます。 

Human68k は、 基本的には アプリ ケー ショ ンが 複数 同時に 動作す る こ 
とがない シングル タスク OS であるた め、 現在 動作して いる アプリ ケー 
ショ ンは メモリ と 画面の 全部を 好きな よう に 使う ことができる 一入 出力 
の 系で あると いえます。 DOS コールは、 そのような アプリケーション か 
ら 利用され る ことを 前提と した サービスを 提供して います。 

それに 対し、 SX-WINDOW 上では 複数の アプリ ケー ショ ンが 同時に 
動作し、 個々 に 画面 出力が あり、 ファイル 入出力が あると いった、 いわ 
ば 多 入出力の 系と なって います。 そのため、 SX コールでは GUI などの 
ウィン ドウ システム 固有の 化理を 提供す ると 同時に、 ウィン ドウと いう 
アプリ ケー ショ ン 固有の 画面を 提供し、 文字列の 描画は ウィン ドウ 内へ、 
ファイルの 化理は 排他的に 斤う といった、 DOS コールでは ほかに 景夕 響を 
与えて しまう ような 化理を 保護す る 役割 もして います。 

また、 SX-WINDOW は Macintosh などで 提供され ている 基本 シス テ 
ム としての ウィン ドウ システムとは 異なり、 SX シュルで 提供され る 疑 
似 マルチ タスク システムを Human68k 上の 1 つの アプリ ケー ショ ン とし 
て 実現して います。 そのため、 IOCS コール や DOS コールに よ り 疑似 
マルチ タスク システムを 破壊す るよう な 行為は 禁止され ています。 これ 
は、 SX-WINDOW の 利点で ある システムの 柔軟 さを 引き出して いると 同 
時に、 システム 保護の 面からは 最大の 弱点で あると もい え、 アプリ ケー 
ショ ンを 作成す るう えで つねにを 意し なければ ならない 点です。 

上の ことから、 SX システムで 提供され るサー ビスには、 疑似 マル 
チ タスクに よる ウィ ン ドウ システム 上で 動作す る アプリ ケー ショ ンに必 
要 不可欠な 要素が 詰 まっている ことが おわかりいた だけた かと 思います。 
この ことは、 言い換えれば SX コールを うま く 利用す る ことによって、 
比較的 簡単に アプリ ケー シ ョンの 構築が 可能で あると いう ことなの です。 
これら SX コールは アプリ ケー ショ ンの 原石と いえる のです。 

それでは、 SX シェル 上で 動作す る アプリ ケー ショ ンが 満たすべき 点は 
何かとい う ことを 次に 考えて みま しよう。 
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SX アプリ ケーシ ヨンの 基礎） 

Human68k アプリ ケーシ ヨンとの 違い 

わたしたちが 慣れ親しんで いる Human68k 上の プログラムと SX- 
WINDOW  上の プロ グラムと では 何が 違 うので しょうか？ 

まず、 前述した ように Human68k は 基本的に シングル タスクで あり、 
SX-WINDOW は 疑似では あるが マルチ タスク 化理を 可能と している と 
いう 点が 挙げ られ ます。 SX-WINDOW 上で 動作す る アプリケーション 
は、 Human68k 上の それとは 違って 画面を 自由に 使う ことは できません 
し、 空き メモリを 自由に 使う といった こと もで きない かわりに、 "他の 夕 
スク に 影響を 与えない 範囲で" という 制限せ きの 自 由が 与え られ てい ま 
す。 それは すなわち、 アプリケーション 固有の ウィンドウを 開く ことで 
あり、 マルチ タスク で 動作す る SX-WINDOW アプ リ ケー シ ョンを 作成 
する う えでの 基本な のです （もちろん、 ウィン ドウを 開かない アプリ ケー 
シヨ ンが 存在して も かまい ません)。 

次に、 SX-WINDOW アプリ ケー シヨ ン での 処理の 流れが、 Human68k 
上で 動作す る ものと 違って、 SX シて ルからの イ ベン ト化理 要 ホを 待ち、 
受け取った イ ベン トの 種類に 対応した 化理を 斤う といった イ ベン ト 駆動 
型の プログラムで なければ ならない という 点が 挙げられます。 

つまり、 すべての SX-WINDOW アプリ ケー シヨ ン において、 

(1)  イベントを 受け取る まで 待機す る。 

(2)  受け取った イベント じ 応じた 化理を 斤う。 

(3)  化理 終了後は 再び イベント 待ちが 態となる。 

という 基本的な 流れと、 マウスの ボタンが 押された、 ネーが 押された と 
いった 各種 イ ベン ト への 対応と いう 2 種類の 化理を 記述し なければ なり 
ません。 

たとえば、 キーが 狎 されたら、 入力され た 文字を 画面に 表示す る 簡素 
な プログラム について 両者の プログラム スタイルを 比較して みると、 


Human68K 

ネーが 押される まで ひたすら 待ち、 何 か 入力され たら その 文字を 表 
示す る。 
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SX-WINDOW 

ひたすら イベント を 待ち 続け、 sx シェルから キー ダウン イベントが 
発行され たら、 その 文字を 表示す る。 

という ようになり ます。 

アプリ ケー ショ ン 側から 見 た 場合、 ネー が 押 される まで 待つ という 点 
では 同じです が、 システム 側から 見た 場合には、 Human68k では アプリ 
ケー ショ ン の化理 だけを 斤って いるのに 対し、 SX-WINDOW では アプ 
リ ケー ショ ンが イベント を 待ち 続けて いる 間に 他の 化理を 斤う こ とがで 
きる 点 に 差が あります。 これが マルチ タスクを 実現ず る 秘訣と なって い 
ます。 

% マルチ タスク プロ グラミ ングの 実現 

これら マルチ タスクを 実現す るた めの 機能は、 マルチ プロ グラミ ング 
方式と いう 概念 じよって います。 マルチプログラミング 方ぶ とは、 メイ 
ン メモリ に 複数個の プログラムを 格納し、 入出力 待ちな どの タイ ミ ング 
で プロ グラムを 切り替える ことによって、 コン ピュー タの 利用 効率を 向 
上させる 内部 化理 形態の 1 つです。 

SX システム における マルチ プロ グラミ ング は、 上で 述べた イベント 駆 
動 型 マルチ タスクに よる 嫂理の ほかに、 メインメモリ に 複数個の プ ログ 
ラムを 格納す るた めの 機構と して、 リエント ラント （再 入） 可能な タスク 
構造が 導入され ています。 

ここで、 リエント ラントとは 何 かを 説明す る 前に、 SX-WINDOW に 
おける タスクの 構造に ついて ふれて おき ま しょう。 

SX-WINDOW における 化理 単位で ある タスクは、 一般に 3 つの メモ 
リ 領域と して、 テキスト 部、 データ 部、 スタック 部を 持って います （Fig. 
1-3)。 テ ネス ト 部は 実際に 実 斤され る プログラムの コードが 格納され て 
いる 領域で あり、 データ 部は さらに 初期化 データ 部と 非 初期化 データ 部 
(bss) じ 分類され ます （初期化 データ 部は 固定 データ、 非 初期化 データ 部は 
変数 データを 格納す る 領域で あると 考えて く ださい)。 
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1)  レジスタ 相対 ア ドレ ッ 
シングに ついては XC 
アセンブラ マニュアル 
などを 参照して く ださ 
し、。 本 含の 後半で 詳し 
く 述べます が、 シャー 
フ ■■純正の  C  コンパイラ 
XC で コンパイルした 場 
合は 条件 3 が 満たされ 
ず、 フリー ソフトの コ 
ン パイ ラで ある 邑 CC の 
SX モー ドと 呼ばれる 特 
殊なス 法で コ ン パイル 
しなければ なりません。 

2)  テキス ト 部を 共有した 
ま ま 再度 タスクと して 
入力で きる という 意 ホ 
です。 

3) 0BJR の R は "再び 
入る" という 意 ホの 英 
語 reentrant の 頭文字 
です。 


Fig. 1-3  • タスクの メモリが 成 巧を 図 


プログラム 領域 


固を データ や 
を 巧 データの 領域 

プログラム 
スタック 領域 


実際に SX-WINDOW が 動作 している 間は、 このような メモリ 構成を 
持つ タスクが SX シ卫 ルで 管理され る メモリ 領域 内に 複数個 存在す る こ 
とになります。 このと き、 X680x0 の メインメモリが 有限で ある ことを 考 
えれば、 SX-WINDOW で 利用で きる タスクの 数は 個々 の タスクが どれ 
だけ メモリを 消贊 する かに 依存して いる ことは 明らかです。 つまり、 夕 
スク が 消費す る メモリを いか に 節約す る かが 重要な 要素 となる わ けです。 

し 力  >  し、 わたしたちが 実際に SX-WINDOW で 使用して いる アプリ ケー 
シヨン のなかには、 エディタ のように プログラム そのもの も 大きく、 大量 
に ワーク メモリ を 消費す るよう な もの も あれば、 ‘‘1 が 計" のよう にわず か 
しか メモリ を消雙 しない 小さな ものまで さま ざまな アプリ ケー シヨ ンが 
存在して おり、 一口に メモリ 消— 雙 量を 抑える といっても 難しい 問題です。 

そこで、 じ I 下の よう な 特別な 条件を 満たす アプリ ケー シヨ ンを 考えて 
みます。 

1.  実行中に プログラムが 変化し ない こと。 

2.  実 斤 中に プログラムに 必要な 固定 データが 変化し ない こと。 

3.  プログラムが データに 対して 特定の ア ドレスに 依存した 形で アク 
セス していな いこと。 

を 件し 2 は、 いわゆる 自己 書き換えを 行って いる プログラム ではない 
ことの 必要条件 であり、 条件 3 は レジスタ 相対 アドレッシング 1) と 呼ば 
れる 手法での み プログラムが 記述され ている ことを 示して います。 

この 3 条件を 満たす プログラムが 存在した 場合、 前述の タスクの メモ 
リ 領域のう ち テ ネス ト 部は 実行中に 変更され る ことなく 固定 領域で ある 
ため、 同じ プログラムを 複数 圃実 斤す る ことがあっても テキス ト部 だけ 
は 共有で きる ことになります （データ 部、 スタック 部 は 新た じ 確保 しなけ 
れ ばな リ ません)。 

このよう な 条件に 見合う タスク 構造を 持った アプリ ケー シヨ ン は、 「リ 
エン ト ラント2) 可能」 な タスク、 もしくは OBJR 型 タスク3) と 呼ばれ、 夕 
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スクの メモリ 消 製 量を 抑える ことができる よう 実装され ています。 

たとえば、 「SX- WINDOW  ver.3.1 システム ネット」 に 付属の‘‘ シャー 
ペン. X" などが 0BJR 型 タスクの 典型的な 例です。 "シ ャー ペン .X" で複 
数の ファイルを 編集 した 場合、 すべての タスク は 最初 に 起動 された タス 
ク" シャー ペン. X，， の テ ネスト 部を 共有し、 編集 ファイルの 内容 や、 編集 
に まつわる パラメータ （々ー ソルの 位置 や カレン トフ ォン ト 情報な ど） を 
タスク 別の データ 部と して 持って いますに のとき の 各 タスクの メモリ 構 
成 図を Fig. 1-4 じ 示す)。 


Fig. 1-4  • 日 BJR 型 タスクを 巧 整 (起 かした ときの メモリ 構成 巧を 図 


•  有する . 

テキスト 部 

テキスト 部 

テキスト 部 

圍 

m: 

圍 

スタック 部 

スタック 部 

スタック 部 

シヤー ペン 1 

シャー ペン 2 

シャー ペン 3 

このほか にも、 SX-WINOOW で' 火む" J ■能な タスク 憐造 として、 じ [下 
の 3 種類が 用意され ています。 

〇  0BJC 型 タスク 

0BJC 型と 呼ばれる タスクは、 0BJR 型 タス ク において 先の 3 条件 
のう ちい ずれ かが、 満たされ ていない テキス ト 部を 有する アプリ ケー 
ション として 位置付けられて います。 この 型の タスクは、 複数 起動 
さ れた 場合に も テキスト 部が 共有 さ れ ず、 0B  JR 型 に比べて メモリ 
の 消費量は 大き くなります。 

〇  0BJ0 型 タスク 

0BJ0 型と 呼ばれる タスクは、 0BJC 型に 比べて さらに 条件が きつ 
く なって おり、 SX-WINDOW 起動 中 には 1 つし か 動作で きないと 
いうを 件が 付加され た アプリ ケーシ ョンです。 例と しては "GRW.X" 
のように、 システムで 1 つし かない 資源で ある グラフィック 画面を 
占有して しまう ため、 同 じ アプリ ケー ショ ンが 複数 起動して は 困 
るよう な 場合に 用いられる タ スク 構造です。 
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〇  0BJX 型 タスク 

0BJX 型と 呼ばれる タスクは 非常に 特殊な タスクで、 アプリ ケー 
ショ ン 実行中に 他の タスクが 動作して いては 困る よう な 場合に 用 
いられます。 現在、 0BJX 塑 タスクと しては、 唯一‘‘ HD フォ ーマッ 
卜 .X" が 存在し ます。 

これら タスク 礫 造に 関する さらに 詳しい 説明は、 『Workroom  SX-68K 
プログラマー ズ マニュアル』 （シャープ)、 もしくは SX 本、 追 補 版を 参照 
してく ださい。 

•  SX アプリケーションと イ ベン ト 処理 

SX 本、 追 補 版で も 述べた ように、 通常、 SX シュル 上で 動作す るアプ 
リ ケー シ ョンが 対応し なければ ならない イベントと して、 じ I 下の 11 種類 
のイ ベン トが あり ます。 


化 ble 1-2  • 対応すべき イ ベン トの巧 巧 


イ ベン トの 種類 

イベント コ ー ド 

アイ ドル イベント 

E_IDLE 

マウス レフト ダウン イベント 

E_MSLD0WN 

マウス レフ ト アップ イベント 

E.MSLUP 

マウス ライト ダウン イベント 

E.MSRDOWN 

マウス ライ ト アップ イベント 

E_MSRUP 

キー ダウン イベント 

E_KEYD0WN 

キー アップ イベント 

E.KEYUP 

アップ デ ー トイ ベント 

E.UPDATE 

アク テイべー トイ ベント 

E_ACTIVATE 

システム イベント 1 

E_SYSTEM1 

システム イベント 2 

E_SYSTEM2 

これらの うち、 システム イベント 1 と システム イベント 2 は 同時に 化 
理 しても かまわな いので、 全部で 10 種類の イベント に対する 化理 だけで 
アプリ ケー ショ ンの 記述が 可能です。 

じ I 下、 イベント と 対応す る化理 内容 じついて 簡単に 説明し ます。 

0 アイ ドル イベント 

アイ ドル イベントは、 SX シ卫 ルから 定期的に 発行され る イベントで 
す。 時 問の 表示 や アニメーション 化理 といった、 ユーザからの 操作 
の 有無に かかわらず 動作し 続ける 化理を 斤う のじ 利用され ます。 
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〇 マウス ダウン イ ベント 

マウス ダウン イベント には、 マウスの 左 ボタ ンが 押された と きに 発 
行され る マウス レフト ダウン イベントと、 右 ボタンに 対応す る マウ 
スライ ト ダウン イベント があります。 

これらは、 マウスの ボタ ンが 押された こ とに よ り 処理が 発生す る 場 
合に 利用され る イベントです。 この イベントには、 マウスの ボタン 
が 押された という 情報の ほかに、 マウスの 位置、 押された ウィンド 
ウの 情報が 付加され ており、 アプリケーションは 「自分の ウィンド 
ウで 押された か」 「ウィンドウの どこの 部分で キ 中され たか」 などに つ 
いて 知る ことが 可能です。 

〇 マウス アップ イベント 

SX— WINDOW  ver.3.1 の SX シェルでは、 この イ ベン トは 発生し ま 
せん。 

0 ネー ダウン イベント 

ネーが 狎 された ときに 発生す るイ ベン ト で、 押された ネーの 内容が 
付加され ています。 キー ボードに よる ショー ト カット •コマンドの 
化理 も、 この イベント 対応 化理で 斤い ます。 

0 ネー アップ イベント 

SX-WINDOW  ver.3.1 の SX シュルでは、 この イ ベン トは 発を しま 
せん。 

〇 アップ デ ー トイ ベント 

他の ウィン ドウの 下に 位置して いた ウィン ドウが 上に 移動した 場合 
など、 ウィン ドウ 内部を 書き直す 必要が あるときに 発生す るイ ベン 
卜 で、 書き直すべき ウィ ン ドウの 情報が 付加され ています。 
SX-WINDOW では、 ウィン ドウ 内部に 描かれて いる 情報に ついて 
SX シェルは なんら 関知せ ず、 ウィン ドウを 關 いた アプリケーション 
が 責任を 持って 揣 画を 斤わなければ なり ません。 

〇アク ティべ ー トイ ベント 

ある ウィンドウが アクティブに なった、 つまり、 画面 上で 一番 上の 
ウィン ドウに なった ときに 発生す るイ ベン ト で、 アクティブ になっ 
た ウィンドウ の 情報が 付加 されて います。 

アク ティべ ー トイ ベン トが 発生す ると、 続いて アップ デ ー トイ ベン 
卜 が 発を します ので、 この イベント で ウィン ドウ 内部の 再 描画を 斤 
う 必要はありません。 あくまでも、 一番 上に なった ことを 示す イべ 
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ン ト である ことにを 意して ください。 


1-1  SX-WINDOW  概説 


〇 システム イベント 

タスク マネージャ や 他の タスク が 特別な 通知 を 斤う 際に 発生す るイ 
ベントです。 SX- WINDOW の 終了 や ファイルの 操作な ど、 タスクの 
動作に 影響す る 化理の 前な どに 発生し ます。 この イベントには、 「シ 
ステ ムイ ベント コード」 と 呼ばれる 通知 内容の 詳細を 示す コードの 
ほかに 各種の 情報が 付加 されます。 複数の タスク 間で 情報を 夕換す 
る、 タスク 閒 通信な ども システム イベントと して 通知され ます。 
システム イ ベン ト 中で、 すべての アプリ ケー シヨ ンが 最低限 対応し 
なければ ならない システム イ ベン ト コードと しての TF の 4 種類が 挙 
げられ ます。 

- NOTICEENDTSK 

タスクの 終了 予告 イ ベン ト です。 タスクが 終了して は 困る 場合 
には、 この イベントを 取り 餘く 化理を 記述して ください。 


•  ENDTSK 


タスクの 終了 イベントです。 タスクを 終了 させなければ なり ま 
せん。 


CL0SEALL 

通常は、 ENDTSK イベント と 同じ 意味を 持って います。 


- WINDOWSELECT 

ウィン ドウが セレクト された ことを なえる イ ベン ト です。 ウィ 
ン ドウを 持って いる アフ 。リ ケー ショ ン では、 ウイン ドウの セレ 
ク ト化理 を 斤わなければ なりません。 

実際に アプリ ケー ショ ンを 作成す る 場合には、 イ ベン ト 待ちを 基本と 
する イ ベン トループ 化理を 骨格と して、 各種 イ ベン ト への 対応 化 理を必 
要に 応じて 追加して いくこと で、 見通しの よい 効率が〕 な 開発が 斤 える で 
しょう。 

9 まとめ 

の 《 上を まとめる と、 SX-WINDOW 上で 動作す る アプリケーションに 
最低限 必要な て 貫目と して 下の 点が 挙げられます。 

(1) アプリケーションの 入 化 力は 自分の ウィンドウを 開き、 その 中で 
のみ 斤う のが 原則で ある。 
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(2)  イベント ループを 中心とし、 を 種 イベントに 呼応す る おぶ の化理 
体系で 記述す る。 

(3)  受け取った イベントへの 対応 化理 は、 できるかぎり 短い 時間で 終 
了 しなければ ならない。 

(4)  DOS コール、 IOCS コールは 原則として 使用して はならない。 

これら を 遵守す る ことは、 SX- WINDOW 上で 動作す る アプ リ ケー ショ 
ンと しての 最低限の マナーで あり、 マルチ タスク プロ グラミ ング への 第 
一歩な のです。 
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1-2  SX アプリケーション 開発 環境 


SX アプリ ケー シヨ ン 開発 環境 


SX- WINDOW  ver.1.0 が 発表され てからす でに 5 年の 歳月が 経過して 
おり、 その 間に 製品、 フリー ソフトを 問わず 多くの SX-WINDOW アプ 
リ ケー シ ョンが 登場し ました。 それら アプリケーションの 開発は 数多く 
の 人たち によって 支えられて きま した。 

「1.1 SX- WINDOW 概説」 （P.4) では、 SX-WINDOW の アプリ ケー 
シ ョンを 作る 場合の プログラム 上の 決ま りに ついて 述べ ま したが、 本節 
では、 SX-WINDOW の バージョンアップの 歴史を 振り返りながら、 ア 
プリ ケー ショ ンを 構築す るた めの コンパイラ、 ライブ ラ リ などに ついて、 
紹介し ます。 

本書で 取り扱う "アプリケーション 開発 環境" とは、 C コンパイラ やア 
セン ブラな どの 開発 言語 ツールの ほかに、 C 言語の ライブ ラ リや インク 
ルー ド ファイル など、 アプリ ケー ショ ンを 開発す る 際に 必要な ソフ トウ ェ 
ア ツール 群 全体を 指す ものと します。 


SX-WINDOW  の 歴史 


1)X68000  SUPER,  EXPERT 
II， PRO  II が 降の マシン 
じは 付属して いません。 


2) このほか、 現在の" シ 
ャー ペン .X" の 前身で 
ある テキス ト エディタ 
"エディタ. X" が 新たに 
付属して いま した。 


X680x0 シリ ーズ用 疑似 マルチ タスク •ウインドウ システム SX-WIN 
DOW の 歴史は、 今から 日 年 程 前の 1990 年 4 巧から 始まります。 

当時、 X68000 シリー ズ には。 ビジュアル シュル （VS.X)" 1) と 呼ばれる 
SX-WINDOW の 前身の ような 简 素な グラフィカル •ユーザ イ ンター フェ ー 
ス による シェルが 付属して いま したが、 実用 性の 面では "COMMAND .X" を 
ビジュアル 化した 程度 のらので した。 X68000  SUPER の 発売と と もに 登 
場した SX-WINDOW  ver.1.0 により、 本格的 な ウィンドウ システム 時代 
の 幕開けと なった のです。 

その後、 化理 速度の 向上を 狙って システム ク ロックを 16MHz に した 
X68000  XVI の 発売に ともない、 化 用 性を 持った 小型 ウィ ン ドウで ある サ 
ブ ウィン ドウ 機能と 印刷機 能を 搭載し、 化理の 高速 化を 行った ver 丄 102) 
が 1991 年 4 巧に リリ ース され ま した。 
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そ して 約 1 年後、 X68000 の シンボルであった ツイ ン タワーを 廃止し、 
小さな ボディ を 売り物 じした X68000  XVI  Compact  (コン パク ト） の 登場 
とと もじ、 フォン ト マンの 搭載に よる アウトライン フォント への 対応、 
実 画面 モー ドの 採用で 画面 スクロールが 可能な 広い デスク ト ップの 提供、 
アイコ ンや メニューを 編集す るた めの 各種 コマン ドの 追加な どじよ る、 
実用 面での 機能 強化を 目的と した ver.2.00 が 1992 年 3 巧に リリー ス され 
ま した。 

さらに その 約 1 年後の 1993 年 4 月、 X68000 シリ ーズ 最高峰の 機種と 
して MPU に 25MHz の MC68EC030 を 搭載した X68030 が 登場し、 65,536 
色 表示 や ビデオ マンの 搭載に よる ウィン ドウ 内部での 動画 表示を サ ポー 
卜 、そ して マルチ フォン ト じよる 高機能 エディタ 。シ ャー ペン .X" が 付属 
した ver.3.0 が 発表され、 大いにを 目を 集め ま した。 

1994 年 5 巧に リ リース さ れた 最新 版で ある SX-WINDOW  ver.3.1 は、 
"シ ャー ペン .X" の ウィン ドウ 内で Human68k の プログラムを 動作させる 
ことが 可能な コンソール モー ドの 追加 や、 イン ライ ン かな 漢字変換を サ 
ポートす るな ど、 主に" シャー ペン .X" の 高性能 化が 斤 われて います。 


SX-WINDOW の アプリ ケー ショ ンを 開発す るた めには、 SX コールを 
呼び出す ためのへ ッ ダと ライブラリ や、 SX-WINDOW アプリケーション 
に 独自の 初期化 処理を 斤う スター ト アップ ルーチンが 必要 じなり ます。 
また、 0B  JR 型アプ リ ケー ショ ンを 作成す る ことので きる 開発 ツ ー ルも必 
要でしょう。 これらの ヘッダと ライブラリ、 開発 ツールを 含めて 「開発 
環境」 と 呼ぶ ことにします。 

Fig. 1-5  •  SX-WINDOW アプリ ケーシ ヨン 作成の 流れ 

ソー スフ アイ ル 
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ここでは、 SX- WINDOW 用の 開発 環境の 歴史を たどった あと、 なぜ、 
本書に 添付され ている 開発 環境が 必要 とな っ たかを 説明 します。 


(； 本書で 提供ず る開凳 環境の 位置づけ） 


SX- WINDOW のこれまでの 開発 環境には、 メー々 （シャープ） 提供の 
開発 キッ ト である 「SX-WINDOW 開発 ネット Workroom  SX-68K」 似 
下、 Workroom と 呼ぶ） と、 フリー ソフ ト 作者 や 書籍に よって 作成、 公表 
された さまざまな 開発 環境が あります。 

各 開発 環境の 特徴に ついては 後述し ますが、 大きく 分ける と、 フリー 
ソフト 作者たち が 作り 上げて き た 開発 環境 と メーカ 主導の 開発 環境と で 
は ソース プログラム レベルでの 互換性が あり ませんで した。 

また、 Workroom の 開発 環境は SX- WINDOW の 最新 バージ ョ ン であ 
る ver. 义 1 ではなく、 ver.2.0 までし か サポート していませんでした。 本書 
で 提供す る 開発 環境は、 Workroom の 開発 環境と の 互換性を 維持 しつつ、 
フリーソフト の 開発 環境の 資産を も 利用で きる 開発 環境を SX-WINDOW 
ver.3.1 ベースで 構築す るた めに 開発され ま した。 

これまでの 開 発 環境と 本書で 提供す る 開 発 環境 との 関係を 簡単に 図に 
まとめる と、 次のように なります。 


Fig. 1-6  •  SX- WINDOW と 閒お巧 巧の 推移 


SX-WINDQW 

C 言語に よる 開発 巧 お 

1990 年 4 巧  ver.1.0 

1 990 年 9 月 

SXKIT 

1991 牛 こ 3 巧 

1 

SX-WINDOW プ ログ ラミン 

1991 年 4  ver.1.10 

! 

追 補 版 

1991 年 12 巧 

SX-WINDOW プ ログ ラミン 

1992 年 3 巧  ver.2.0 

■ 

1993 年 1 月 

Devlop. 

1993 年 4 巧  ver.3.0 

1 

1993 年 5 月 

libc 

1994 年 5 巧  ver.3.1 

1 

Workroom  SX-68K 

1994 年 9 巧 

Develop&libc  II 

ver.2.0 が 広; 

(LIBSXC) 


LiJsXC  - 


-callno- 


- SX31  KIT 


本書で 提供す る 開発 おお 


このように、 本書で 提供す る 開発 環境は 開発 環境の 最新 版で あると と 
もに、 それぞれの 開発 環境を 統合して 扱う 開発 環境に なって います。 
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SX - WINDOW 關発 環境の 歴史 


ここでは、 これまでに 公表され ている 主な 開発 環境には どんな ものが 
あり、 その 特徴は 何 かにつ いて 説明し ます。 フリーソフト として 配布 さ 
れ ている ソース プログラムを コンパイル する 際な ど、 これらの 歴史 や 関 
係 等を 知って おくと 便利でしょう。 また、 本書で 提供す る 開発 環境が ど 
んな もので あるかを 知る う えで も 重要です。 

ここでい う關発 環境とは、 〔コンパイラ、 ヘッダ （インクルード フ アイ 
ル)、 ライブラリを 指します。 これら SX- WINDOW の 開発 環境に ついて、 
どのような ものが 今までに 存在し 利用され てきた のかに ついて じ I 下 順を 
追って 概説し、 最後に 本書で 提供す る 稚奨闡 発 環境に ついて 紹介し ます。 


%  SX-WINDOW 閒発巧 巧 （コンパイラ 編) 


SX-WINDOW アプリ ケー シヨ ンの關 発に 利用され ている C コン ハ。 イ 
ラは、 じ I 下の 2 種類に 大きく 分類され ます。 


〇  「X68000  C  COMPILER  PRO-68K  ver.2.0  (もしくは  ver.2.1)」 
0  FSF の フリーソフト である 「GNU  C  compiler」 の 移植 版 


3)X68030 じ 対応した ライ 
ブ ラリ が同捆 されて い 
ます。 


前者は、 シャープから 発売され ている X68000 用 メーカ 純正 C コンパ 
イ ラで あり、 通常は X680x0 用 C コ ン パイ ラを 略して XC と 呼ばれて い 
ます。 1995 年 6 巧 現在の 最新 バージョンは ver.2.1 で、 のちほど 紹介す る 
Workroom で 推奨され ている C コ ンパ イラです3)。 

後者の GNU  C  compiler は、 Richard  Stallman 氏ら じよる FSF (フリー 
ソフ トウ 卫ア ファウンデーション） で 開発され た 高性能 C コンパイラ であ 
り、 通称 gcc と 呼ばれて います。 X680x0 用と して 移植され ている gcc は、 
パソコ ン 通信 上 や 書籍 『X68k  Programming  Series  (#0)  X680x0  Develop. 
& 1 化 c  II』 （ソフ ト バンク 刊） ル: i 下、 Develop.  & libc  II と 呼ぶ） の 添付 ディ 
スク などで 配布され ています。 gcc は 最適化の 性能に おいて、 前 出の XC 
を 凌駕して おり、 最近の 移植 版では SX-WINDOW アプリケーション 開 
発の ための 特殊機能の 追加な ども 斤 われて います。 今日では 邑 CC の ほう 
が 一般的に 使われて いるよう です。 
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4) SX— WINDOW  ver.I.O の 
頃の アセンブラ だけの 
開発 環境に 比べれば、 
なんという 進歩な ので 
しよう 力、。 

引 フリー の ライブラリ 
である LIBC を SX- 
WINDOW 用に 披 張し 
た ライブラリ。 詳しく 
は、 第 4 牽 「UBSXCj 
(P.I27) を 参照して くど 
さし、。 


そのほか、 Charlie 氏に よって、 C 言語、 C++ 言語、 Objective-C 言語 
をコ ン パイ ル 可能な 最新 版 gcc  ver.2.6.3  (通称 gcc2) の 移植が 斤 われて 
おり、 こちら も gcc 同様、 SX-WINDOW アプリケーション 開発の ため 
の 機能 拡張が 施されて います （開発 途上では あり ます 力ぶ、 作者の ご 厚意に 
よ り 本書の 添付 CD-ROM じ 収録 させて いただき ま した)。 この gcc2 の 
登場に よって、 C++ や Objective-C で SX-WINDOW アプリケーション 
を 作成す る 人 も 見受けられ るよう になり ま した4)。 

本書で 提供す る 開発 環境では、 callno  header と LIBSXC  5) が gcc 
の 利用を 前提に 開発され ています。 XC では SX31KIT しか 利用で きませ 
ん ので、 極力 gcc を 利用した アプリ ケー シヨ ン 開発を お勧めし ます。 


- gcc の SX-WINDOW 用が 張 機能 


gcc は 無料で 使用で きる コ ン パイ ラです が、 市販され ている コ ン パイ 
ラより も 高性能な ことから、 ワーク ステ ー ショ ン 用から パソコン 用まで 
多くの 人々 に 愛用され ています。 X680x0 じ 移植され たものは、 本来の 
gcc が 備えて いた お 張 機能に 加えて、 X680x0 の 環境に 特化した 拡張 機能 
が 付加 されて います （gcc の お 張 機能の 特徴に ついては コラムを 参照して 
ください)。 


©コラ 厶： gcc の 拡張 機能 


呂 CC は、 もともと ワー クス テー シヨ ン 
の 世界で 生まれ 育って きた コンパイ ラで 
す。 X680x0 には パソコン としては かな 
リ 早い 時期に 移植が 始まり、 多くの 人々 
の 努力 じよ っ て 極めて 高性能な コ ン パイ 
ラに 成 農し ま した。 

gcc の 特徴は、 まず、 ANSI 完全 対応 + 
びの 文法を サポート している ことで しょ 
う （XC は 準が をう たって はいます が、 完 
全には が応 していません)。 しかしな 力、‘ 
ら、 過 まの 资 産を 活用で きる よう、 「な 
統 的な」 文法 (K&R のよう な） で 記述 さ 
れた ソース にも が応で きる ようじ なって 
います。 これを 切り替える のが‘‘- an が’, 
" -traditional" といった オフ。 シヨ ン です。 

また、 gcc は 非常に 効率の よい 実 斤コー 


ドを 生成す る ことで も 知られて いますが、 
その 嚴遮 化の 方法 もき め 細かく 指定で き 
ます。 で 始まる レジスタ 割り 付-け 才 
プシ ョンを 駆使す る ことじ よって、 コン 
パイ ルが の 動作を き め 細かく ネ旨定 できる 
のです が、 どのような 組み合わせが 有効 
であるか、 作成す る プログラムの 特性に 
あわせて 見極める 必要が あり ます。 

X680x0 版に 特化した 拡張 機能と して、 
本文では "-SX" オプションを 紹 かしてい 
ます 力、’、 このほか にも 多くの X680x0 用 
オプション カ 《存在し ます。 ここでは とても 
紹介し きれません ので、 ぜひ 『Develop. 
&UbcII』 も お 手元に 置かれる ことを お 
勧め します。 
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ここでは、 X680x0 版 gcc の SX-WINDOW 用 拡張 機能に ついて 紹介し 
ます。 お 張 機能と しては、 現在、 り I 下の ような ものが 用意され ています。 

〇 リエント ラントな プログラム 開発を 支援す る 機能 

gcc は "-SX" オプ ショ ンを つけて コ ン パイルす ると、 すべての 変 
数を A5 レジスタからの オフ セッ トで アクセス する ような コードを 
出力 します。 

これ じよって コード 部分が 共有で きる、 つまり、 リエント ラントな 
コードを 自動的に 作成す る ことが 可能と なります。 この場合、 変 
数は .rdata セクションに 置かれます （セク ショ ン について は コラ 
ムを 参照して ください)。 

〇  remote  宣言 

前述のと おり、 "-SX" オプションを つけた 場合、 通常の 変数は A5 
レジスタからの オフ セッ トで アクセス されます。 remote 宣言は、 
変数の アクセスの 際の オフ セッ トが 64K バイ トを 超える 大きさと 
なる 場合に、 オフ セ ットを 32 ビッ トで 扱える よう にす るた めの 予 
約 語です。 

remote 宣言され た 変数は 32 ビッ トの オフ セッ ト じよる アクセス 
が 可能 となり ま すが、 MC68000 マイクロ プロ セッ サの マシ ン語命 
令では 1 命令で 対応す る こと がで きない ことから 命令 コード が 複雑 
となり、 結果 的に その 変数への アクセスは 遅く なって しまいます。 
この 指定が 斤 われた 変数は .rldata セク ショ ンに 置かれます。 

〇  common  宣吕 

"-SX" オプ ショ ン によって、 通常の 変数は すべて A5 レジスタ か 
らの オフ セッ トで アクセスされ るよ うな コードが 出力され ますが、 
common 宣言を 斤った 変数は、 通常の .data あるいは .bss セク 
ショ ンに 割リ竺 てられ、 直 ネ妾ア ドレスを 指定して アクセスす るよ 
うな コー ドが を 成されます。 

〇  SXCALL  宣言 

SX システムで 提供され る サービス である SX コールは、 通常、 ラ 
イブ ラリ を 呼び出, す 形式で コー ドが 生成され るのに 対して、 この 
SXCALL 宣言を 関数の プロ ト タイプに 付加す る ことで、 SX コール 
が 直接 呼び 化される よう な コー ドが 生成され ます。 これに よって、 
ライ ブ ラリ を 呼び 化す オーバーへ ッ ドが 軽減され 、より 実 斤 効率 
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©コラ 厶 ： セクション 


セクションとは、 アセンブルの 際に 便 
宜 的に 使用され る コード/データの 格納 場 
所の 区分の こ とです。 

XC 【こか 属する as.x や Ik.x は、 
.text,  .  data,  .  bss といった セク ショ 
ンを サポートして います。 これらは それ 
ぞれ、 コードを 格納す る 領域、 プロ グラ 
ム 開始 時に ネ刀期 値を 入れて おく 必要が あ 
る データを 格納す る 領域、 そして 初期値 
を 入れて おく 必要がない 変数を 格納す る 
領域を 意味して います。 アセンブラ ソー 
ス のなかで 適宜 セク ショ ンの 指定を 斤う 
ことで、 それぞれの セクション じ 格納す 
べき コード、 ないしは デー タが 適当に ま 
とめられて 配置され ます。 

Human68k 上で 動作す る アプ り ケー 
シ ョンの 場合は、 この 程度の セクション 
の 指定 だけで 用が 足り たのです が、 SX- 
WINDOW 上で 効率よ く 動作す る アプリ 
ケー シ ョンを 作る ためには、 少し 性格の 
異なった セク ショ ンが 必要と なり ます。 

SX- WINDOW 上で メモリを もっとも 
上手に 使って 効率よ く 動作で きる のは 
「D 巨 JR 型 モジ ュー ル」 と 呼ばれる タイ 
プの実 斤 形式です。 0BJR 型 モジュール 
は リエント ラントな コー ドで 作られて い 
なければ ならず、 変数な どが 固定された 
ア ドレスに 格納され る ことは 許され ませ 
ん。 それらの データは 「データ エリア J 
に 格納され、 A5 レジスタを ベースに し 
た オフ セッ ト 指定で アクセス する 必要が 
ちります。 しかし、 前述の. data,  .bss 
といった セクションは、 プログラムに ち- 
えら れた メモリ  中の 固定された ア ドレス 
領域を 使用す るた めの セクション なので、 
ここでは 適切では あり ません。 

このような 背景から 「ある レジスタを 
ベー ス にした オフ セッ ト 指定で アクセス 
する デー タを 格納す るた めの セクション」 
が 必要 となります。 

フリー ソフ トの アセンブラ と リン々 で 


ある、 has . X,  hlk.x では、 上記の よ 
う なネ 目対ア ドレス 指定で アクセスす るた 
めじ 「相対 セクション」 を 追加し ました。 

相対 セ クシ ョンには いく つか 種類が あ 
ります が、 ここでは 本文 中に 登場す る 
. rdata,  .rl 过 ata セクション じつい 
ての み ふれる ことと します。 その他の セ 
クシ ョ ンの 詳細に ついては rX68k  Pro¬ 
gramming  Series  (#1)  X68000  Develop.』 
(ソフ ト バンク 干り） を 参照して ください。 

〇 .  rdata セクション 
. rdata セクションは、 ある レジスタ 
(SX- WINDOW 用 アプリ ケーシ ョンの 
場合、 データエ リアの 先頭を 指す A5 レ 
ジ スタ） をべー ス じ、 64K バイ トの 範囲 
を カバー する ための セクションです。 64K 
バイ ト という 制限は、 MC 68000 の アド レ 
ス レジスタ 相が アド レッ シン グで 指定で 
きる オフ セッ トの サイズが ワー ドで ある 
ことじ 由来して います。 MC68000 でも 1 
命令で アクセス できる ことから 高速な ア 
ク セスが 可能です。 

〇 .  rldata 七 クシ ヨン 
. rldata セクションは、 ある レジスタ 
(.rdata と 同様に、 A5) を ベースに、 
232 の範 晒を 指定で き、 X68000 の 全 メモ 
リ 空間で ある 16M バイ トの 範囲を々 バー 
する ための 七 クシ ョンです。 オフセットを 
ロ ン グワー ドで 指定す るた めじ 64K バイ 
卜 という 制限は あり ません が、 MC68000 
の 1 命令では アクセス できず、 .rdata 
セク ショ ン に比べて 若干 アクセス 速度が 
落ちます。 

gcc は、 これらの 新しい セクションに 
対応 した コードを 自 動的 じ 作成 します の 
で、 gcc  +  has  +  hlk という 組み合わ 
せで 開発を 斤う かぎり、 開発 者は 特に 意 
識 する ことなく、 リエント ラントな コー 
ドを 作成す る ことが 可能と なり ます。 
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のよ い プログラムを 作成す る ことが 可能と なり ます。 詳細に つい 
ては、 「callno  header の 仕様」 （p.115) を 参照 してく ださい。 


言語 標準 ライブラリ 

さらに、 C コンパイラで 利用され る C 言語 用の 標準 ライブラリ とへ ッ 
ダ ファイル （イ ン クルー ド ファイル） についても 言及して おき ま しよう。 

C 言語 用の 標準 ライブラリ じは、 コ ンパ イラ に 対応しての I 下の 2 種類 
が あり ます。 


6)  米国 規格 協を (ANSI  - 
American  National  Stan¬ 
dards  Institute) の 委員 
会で 承認、 制を された C 
言語の 標準化 案の こと。 

7)  ホ 国 電気電子 学会 (IEEE 
— the  Institute  of  Electri¬ 
cal  and  Electronics  Engi¬ 
neers,  Inc.) が 制定した 
オペ レーテイ ング シス 
テムに 関する 標準化 案 
のこと。 


8)  Public  Domain  Software 
の 略。 著作者が、 著作 
権を 行使し ない ことを 
宣言した ソフ トウ エア 
のこと。 

9)  たとえば、 メモリを 確 
保す る malloc 関数 や 
ファイル オープン 動作 
を 行う fopen 関数な 
ど。 


〇  XC ライブラリ 

シャープ 純正 コンパイ ラ 付属の ライブ ラ リ です。 すべて ア セン ブ 
ラ で 記述され ている ため、 比較的 高速な ものと なって います。 

0  LIBC 

LIBC は、 パソコン通信 上 や 書籍 『Develop.  & 1 化 c  II』 の 添付 ディ 
スクで 配布され ている ライブラリで、 gcc から 利用され る ことを 
前提と して 作成され ています。 

かなり 多くの 闡 数が C 言語で 記述され ている ため、 ライブラリの 
内容に 変更を 加える こと も 容易です。 また、 ANSI  C6) の 仕様を 満 
たし、 POSIX の ライブ ラ リ などの 仕様を 可能な かぎり 取り込んで 
いますので、 UNIX で 利用され ている ツールの 移植の 際に 威力を 
発揮し ます。 

LIBC は、 PDS  8) であると 宣言され ており、 バイナリ だけでなく 
ソース も 公 離されて います。 

いずれも SX-WINDOW 用の ライブラリ ではありません が、 〔言語で 
プログラムを 作成す るう えで 必要 不可欠な ものと なって います。 

ここで 注意し なければ ならない のは、 上記 ライブラリ は 基本的に Hu- 
man68k の プログラムで 利用す るた めに 作られた もので あり、 SX-WIN 
DOW 上で 動作す る プログラムから 利用され る こ とは いっさい 考えられ 
ていない という こ とです。 

SX-WINDOW では、 Human68k と は メモリ 管理 やフ ァイ ル 管理の 方 
法が 異なる ため、 前 出の XC や LIBC に 含まれて いる 多くの 標準 ライブ 
ラリ 闕 数9) を 利用す る ことは できません。 
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10) 本書の 筆者の I 人で あ 
る 西 田文彥 氏。 


11) 多 田知顕 氏。 草の根 
BBS  の  Network-SX  ネリ 
代 シスオペ。 アー カイ 
ブ された ファイル じ 対 
して SX— WINDOW 上で 
普通の ディ レクト リと 
同様な 操作を 堤 供す る 
フリー ソフト ViSON な 
どを 発表して います。 


そのため、 これら Human68k 用 C 言語 標準 ライブラリを、 SX-WIN 
DOW アプリ ケー ショ ンか らも 利用 可能と する よう に さまざま なな 良を 
斤った 標準 ライブラリが パワー ユーザの 手 じよって 作成され ています。 現 
在、 確認され ている ものは じ I 下の 2 種類で、 それぞれ XC，gcc 用 ライブ 
ラリ をな 良した ものと なって います。 

〇  SXCLIB 

SXCLIB(  KUM 氏 1 の 移植） は、 XC ライブラリを もとに SX-WIN 
DOW 用の 改良を 斤った ライブラリです。 XC ライブラリ と 高い 互 
換 性を 持って います 力ぶ、 現を では 古い ものと なって おり、 ほとんど 
利用され ていません。 


〇  LIBSXC 

LIBSXC  (Niggle 氏 W、 KUM 氏 移植） は、 Human68k 用 標準 〔ライ 
ブ ラリ LIBC を もとに SX-WINDOW 用の 改良を 斤った ライブ ラ 
リ で、 本書の 添が-フロ ッ ピー ディ スク 、なら びに 添付 CD- ROM に 
収録して あり ます。 

LIBSXC は 本書の 筆者たち 力ぶ 推奨す る 開発 環境の 1 つで あり、 LIBC 
と 上位互換性を 保って いる ことから、 LIBC 同様、 UNIX の ソフト 
ゥュア 資産を 流用す る 場合な どに も 移植に ともなう 作業が 軽減 さ 
れ ます。 

LIBSXC について は、 第 4 章 「LIBSXC」 （p.l27) で 詳説し ます。 


0SX-WINDOW 開発 巧 境 （SX ライブラリ 編） 

ここでは、 〔言語で SX- WINDOW アプリ ケー ショ ンを 開発す る じあ 
たって、 従来から 利用され てきた ライブラリ を 紹介し ます。 

SX コールを 呼び出す ための ライブ ラ リ 環境は、 標準と なる シャープ か 
らの 開発 環境の 提供が 比較的 遅かった ため、 多数 存在し ます。 これらの 
ライブラリ を 大き く 分ける と、 次の 3 つに 分類す る ことができます。 

〇 フリーソフト 作者たち がまと めた SXKIT 
〇 追 補 版の 添付 •ライブラリ 
U  Workroom 

U 下では、 これらを 個別に 取り上げて、 その 内容と 特徴に ついて 述べ 
ると ともに、 本書で 提供す る 開 発 環境 との 違いに ついて 説明し ます。 
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►フリ ーソフ ト 作者たち がまと めた SXKIT 


12) ' 冲 滕 氏。 フリー ソフ 

卜 作者と して さま ざ 
まな ネット ワーク 上で 
活躍して います。 SX- 
WINDOW 上の 代表作と 
して、 プログラミング 
中に バス エラーや ア 
ドレス エラーが 発生 
しても 回復可能 じする 
SXerror や、 エディタ 
の SXng の 移植な ど、 
多数の フ リー ソフトを 
作成して います。 

13)  冲 勝、 田 □毅、 青木 司、 
清水 和义、 田 中和 明の 
を 氏 や、 その他 多くの 
人たち が 協力して SX- 
WINDOW  の解ネ 斤を 斤つ 
ています。 

14) MacOS の SX システム 
じ 相当す る 部み。 

15)  使用 頻度の ィ をい コール 
や、 シェル 用の 複雑な 
コ ー ルな どの 解ネ 斤は 困 
難ピっ たようです。 


16) た とえば、 Workroom/ 
追 補 版で いう WMNew 
関数は NewWindow と 
いう 関数 名に なって い 
ます。 


SXKIT は、 X680x0 用の フリーソフト を 精力 的に 作成して きた 沖 @ 沖 
氏 じ） ら I3) が、 FSX.X や SXWIN.X を 解析して まとめた 開発 キッ ト です。 

フリー ソフ トの ため 市販は されませんで したが、 パソコン通信 上で 最 
初に 公開され た 開発 環境で ある ことと、 C 言語の 離 発 環境で ある こと、 
Macintosh の Too 旧 ox  ^ に 近い 構造体 名 や 関数 名を 使用して いる 点な ど 
が 特徴と いえます。 

SXKIT は 有志に よる 解析を もとに して 構築され た ライブラリ です ので、 
解析が 終了 していない 部 か け) じついて は サポート されて いません。 構造 
体の 名前 や 関数 名が Workroom や 追 補 版とは まったく 異なり ます i6) の 
で、 過 まの ソースを 活用し よう とする 場合には ソース プログラムを 大き 
く 変更す る 必要が あります。 

SX-WINDOW が 発表され たばか リ で、 資料な ども いっさいなかった 
当時、 SX-WINDOW での プログラミングを 志す 人たち は、 全員、 この 
ヘッダと ライブラリ を 使用して いたと いっても 過言では あり ません。 そ 
の 後、 より 詳細な 情報が 本と して 出版され たので、 一般には 徐 々に 使用 
されな く なって いったよう です。 

なお、 本書で 提供す る 開発 キットは SX31KIT という 名前です が、 SXKIT 
とは 特に 関連性は あり ません。 

SXKIT から 本書で 提供す る 開発 環境まで、 その 内容が どのよう に 変わっ 
ていった か、 その 変遷を ご 鏡いた だくた めじ、 もっとも 顕著に 変わって 
きた EventRecord 型の 内容を 紹介し ます。 

SXKIT では、 下記の ように 定義され ています。 


[ List  1-1 •  EventRecord  型のを を 

1 : typedei  struct  { 

2  :  short  what ; 

6 :  int  message; 

4 :  int  when; 

5  :  Point  where ; 

6  :  short  皿 odiiiers; 

7  :  }  EventRecord; 


これは 基本的に ToolBox の 定義と 同一で あり、 SXK  口が ToolBox を 
参考に 作られて いる こと を 端的に 示して います。 
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17) 「追 補 版  SX- WINDOW 
プログラミング J は、 巷 
では" SX 本 +  +  " と 呼ば 
れる 場合が あります。 


追 補 版では、 SX-WINDOWver 丄 1 までの アセンブラ マクロ、 〔言語の 
へッ ダと ライブラリ カ s' 提供され ています。 

この ライブラリ とへ ッ ダの SX コー ルの 命名 方式 や 構造体の 型 名が iU 
後、 比較的 広く 誓な したよう です I7)。 

SX コール 名は ToolBox 風の 名前とは 異なり、 コール 名の 先頭 2 文字 
が マネージャ 名を 意睐 する よう になり ま した。 コール 名が マネージャ ご 
とに 分類され たこと から、 プログラムを 作る 場合 も 読む 場合 も、 その 化 
理 内容を 理解し やすく なって います。 

構造体の 定義に ついても 整理され ています。 イベントの 情報を なえる 
event 型の 定義を 追 補 版の ヘッダ か らホ友 粋す ると、 下記の ようじな り 
ます。 


[ List  1-2  •  event  型のを お 


2 

3 

4 

5 

6 

7 

8 
9 


typedef  struct  event  { 


short 

eWhat ; 

/ 幸 

イ ベン トの 種類 

幸/ 

long 

eWhom; 

/幸 

イ ベン トじ 関連した 引数*/ 

1111 signed 

long 

eWhen; 

/* 

イ ベン トの 発生 時 （シス*/ 

/幸 

テム 内部 カウント） 

幸/ 

point _t 

©Where; 

/* 

マウスの 座標 （グロ 

—バ 幸/ 

/* 

ル 座標系） 

幸/ 

unsigned 

Ion 居 

eHow; 

/幸 

特殊 キーの 状態 

幸/ 

}  event ; 


基本的に 型 名が (event のように） 小文字から 始まって いるの が 特徴 
です。 

追 補 版のへ ッ ダと ライブラリは 長期に わたって 使用され てきた ことか 
ら、 ホく から SX-WINDOW で プロ グラミ ングを している ユーザの 間で 
は 現を でも 利用され る 場合が あり ます。 


►  Workroom 


シャ ープが 提供した Workroom では、 SX— WINDOW  ver.2.0 ま で' の 了 
セン ブラ マクロ、 C 言語の ヘッダと ライブ ラ リカ s' 提供され ています。 

構造体の 型 名 や SX コール 名の 標準と なる はずの ライブ ラ リ といえ ま 
すが、 関数 名は 追 補 版の ライブラリと 同じで ある ものの、 構造体 名 や 型 
名、 定数 名が 追 補 版の ものとは 異なります。 
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このため、 Workroom 発売の I 前から 作られて いた 追 補 版のへ ッ ダを 用 
いた フ リー ソフ トの ソースファイルを コ ン パイルす る こ とがで き ません。 
追 補 版のへ ッ ダから Workroom の ヘッダ'  へ 対応す る ための ソー スフ ァイ 
ルの 変更は 大変な 作業 量と なり、 いまだに Workroom 形式への 移 斤は 進 
んで おらず、 現を でも 追 補 版 形式の ヘッダと ライブ ラ リ 用の ソース プロ 
グラムが 見受けられます。 

構造体 名の 違いを、 Event 型の 定義を 例に とって 示します (Workroom 
の SXDEF2.H から 抜粋)。 


1  List  1-3  •  Event  型のを 巧  | 

1 : Struct 

Event  { 

2: 

short  what; 

3: 

union  { 

4: 

Window  ♦win; 

5: 

struct  { 

6: 

short  code ; 

7: 

short  ascii; 

8: 

>  key; 

9: 

lo 凸 g  data; 

10: 

}  whom; 

11: 

unsigned  long  when; 

12: 

Point  where ; 

13: 

unsigned  long  how; 

14:  }; 

まず、 第 1 に Workroom では、 型 名 （たと え ば Event など） は 大文字 
から 始まって い るの が' 特徴です。 

第 2 の 特徴と して、 C 言語の 文法 じより 無理な く 適合で き るよう にエ 
夫され ている ことが 挙げられます。 

イベント レコードは、 what の 値に よって その他の 要素の 意味が 変わっ 
てきます。 そのため、 SXKIT や 追 補 版の 定義では、 キャストを 駆使して 
C 言語の 文法に 適合させる 必要が あった のです 力ぶ、 Workroom では、 もっ 
と 無理な く 使用で き るよう union を 使った 定義が 巧 われて います。 

what の 値が 意味す る イベント の 種類に よって、 whom の 意味す る もの 
は ウィン ドウ レコ ー ド への ポインタ、 キ ー コ ー ド/  ASCII コ ー ド、 その他 
の データと いった 3 種類に 読み 換える 必要が あります。 たとえば、 アッ 
プデ ー トイ ベント の 場合、 whom は ウィ ン ドウ レコ ー ド への ポインタ とし 
て 解釈し、 キー ダウン イベントの 場合は 上位 ワードを キー コード、 下位 
ワードを ASCII コードと して 解釈す る 必要が あり ます。 


28 


1-2  SX アフリ ケーシ ヨン 開発 巧 巧 


18) ちなみ じ、 追 補 版の 
handle のま: をは 間違 
つてい ます。 


追 補 版の 定義では、 アップ デ ー トイ ベン ト 時の ウィン ドウ レコードや、 
キー ダウン イ ベン ト 時の ネー コー ドの 値を 得る 場合 じは、 次の ような コー 
ディ ングが 必要でした。 

〇 ウインドウ レコード： 

winPtr  =  window*)  (  event .  eWhonU  ; 

〇 ネー コード： 

keyCode  =  (  event . e Who 皿）  >>  16; 

一方、 Workroom では、 それぞれ じ I 下の ようじ 記述で きます。 

〇 ウインドウ レコード： 

winPtr  =  event .who 皿. win; 

〇 ネー コード： 

kevCode  =  event . whom. key. code ; 

C 言語の コードと しては 巧ら かに Workroom の ほう が スマ ー トで すが、 
どちらが 使いやす いかは プログラム 作成者の 好みの 問題でしょう。 

型の 名前 も 構造体 名と 同様で、 先頭の 1 文字が 大文字 となって います。 
たとえば、 ポイ ンタや ハン ドルを 表現す る 型は の rr のよう な 違いが あり 
ます I8)。 

〇 追 補 版： 

tvpedef  void  幸 pointer; 

typedef  void  *haiidle ; 

O  Workroom: 

typedef  voi 过  *Pointer ; 

typedef  void  **Handle; 

を 数の 名前は、 Workroom になって 定義され ないよう になった もの 
(S 朋 RTCUT 等） や、 新しく 定義され たものに HRBTN_H 等)、 名前が 変わ っ 
たものに し CHRBTN 等） が それぞれ 多数 あり ます。 


本書で 提供ず る 開発 環境） 


それでは、 本書で 提供す る SX-WINDOW  ver.3.1 対応 ライ ブ ラリ につ 
いて 簡単に 紹介し ましょう。 


29 


Chapter 1 SX-WINDOW プログラミングの 基礎 


0SX31KIT 

SX31KIT は、 SX-WINDOW  ver.2.0 までし か 対応して いない Workroom 
を 拡張する ことじ よって、 ver.3.1 に 対応した アプリ ケー ショ ンを 作成 可 
能と する、 ヘッダと ライブラリの セットです。 

内容 的 じは、 Workroom の 上位 互換 となって おり、 Workroom を 利用 
して コンパイル できる プログラムは そのまま SX31KIT でも コ ン パイルす 
る ことができます。 ただし、 追 補 版の ヘッダ や ライブラリとは 互換性が 
あり ません ので ご注意く ださい。 

sxsiKrr について は、 「3.1  SKSiKrr とは」 （口.74) で 詳説し ます。 


callno  header 

callno  header は、 Workroom およ び 追 補 版のへ ッ ダフ ァイ ルと 互 
換 性の ある ヘッダです。 この ヘッダでは、 SX-WINDOW  ver.3.1 までの 
SX コールを ライブラリを 通して 呼び 化す 形式では なく、 直接 A-line 
trap 命令を イ ン ライン アセンブラと して 展開す る 形式で 闕 数を 宣言し 
ています。 

callno  header のへ ッ ダフ ァイ ルでは、 型 や 構造体の 定義が 含まれ 
ていない ため、 追 補 版 もしくは Workroom の ヘッダ' ファ イ ルが 必要と な 
ります。 このと き、 どちらの ヘッダ ファイルを 併用す るかに よって、 い 
ずれ かの 互換 開発 環境と して 機能し ます。 

callno  header  について は、 「3.3  callno  header」 （p.lll) で 詳説 
します。 

t  LIBSXC 

LIBSXC はすで に 述べた ように、 Human68k 用 標準 〔ライ ブ ラリ であ 
る LIBC に、 SX-WINDOW 上では 使えない 標準 ライブ ラ リ闕 数を 同様な 
機能を 提供す る SX コールに 置き換える などの 化 霞を 施した、 C 言語で 
の SX-WINDOW アプリ ケー ショ ンの 開発を サポー ト する gcc 用 〔言語 
標準 ライブラリ です。 

LIBSXC じついて は、 第 4 章 「LIBSXC」 （p.127) で 詳説し ます。 
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開発 環境の 組み合わせ) 


じ I 上、 これまでの 開 発 環境と 本專で 提供す る 開 発 環境の 関係を 解説し 
てき ま した。 

本書で 紹介す る 開発 環境は、 「追 補 版 ヘッグ '& ライブラリ」、 「Workroom」、 
「LIBC」 といった X680x0 の 代表 ft 勺な 觸発 環境を 統合し、 これまでの ソフ 
トウ ュア的 資産 や 開発 経験を すべて SX-WINDOW 用 アプリ ケーン ョン 
に 注ぎを める ようにす る ことを 旨標と しています。 

「XC  +  Workroom  +  SX31KIT」 や、 「gcc  +  追 補 版へ ッ ダ  +  callno 
header  +  LIBSXC 」 などの ように、 かなり 自阳に 組み合わせて 使用で 
きる ため、 どのよう な 使い方を すれば よいの か 混乱して しまう かも しれ 
ません が、 ia 下の 説明を 読んで いただく ことで、 あなたに とっての ベス 
卜な 環境が おのず と 決まって く る こと と 思います。 

と り あえず、 いくつかの 推奨 プランを 示して おきます ので 参考 じして 
ください。 

〇 初心者 コース 

SX- WINDOW プログラミング 初心者で、 雛し いことは ともかく、" 動 
く  "SX-WINDOW アプリ ケー ショ ンを 作り たいとい う 方への お勧めは、 


「XC  +  Workroom  +  SX31KIT」 


です。 

Workroom を 基本に 据える ことで、 Workroom に 用意され ている サン 
プル プログラムを そのまま 使って 学習す る ことができます。 学習が 進ん 
だと ころで、 SX-WINDOW  ver.3.0 の の 機能 を 使いた く なった ときに 
も 対応で きます。 

環境 粹 礫の 手間 力 s' 最小限で すむ のが ポ イン ト です。 

〇 中級 者コ ー ス 

Human68k 用 アプリ ケーシ ョンを gcc  +  LIBC で 作って いるが、 SX- 
WINDOW プロ グラミ ングの 経驗が あまり ない 方への お勧めは、 


「だ  CC  +  Workroom  +  SX31KIT  +  LIBSXC」 


です。 
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gcc での プロ グラミ ング 経験を そのまま 活かしながら、 SX-WINDOW 
ver.3.1 まで 対応した アプリケーションを 記述で きる のが 利点です。 

〇 上級 者 コース 

Human68k 用 アプリケーションを gcc  +  LIBC で 作って いて、 SX- 
WINDOW  の アプリ ケー ショ ン でもを 協の ない ものを 作り たい 方への お 
勧めは、 

「gcc  +  Workroom  +  SX31KIT  +  callno  header  +  LIBSXC」 


です。 

gcc での プロ グラミ ング 経験を そのまま 活かしながら、 SX-WINDOW 
ver.3.1 ま で 対応し た 高速な アプ リ ケー シヨ ンを 作成す る こと がで きます。 
ほ とん ど 究極の 形態 という こと がで きます。 

〇 古参 コ ース 

今 さ ら追補 版 環境を 壊せない、 という 古参 SXer の 方への お勧めは、 


「gcc  +  追 補 版 ヘッダ  +  callno  header  +  LIBSXCj 


です。 思うよう に、 SX-WINDOW  ver. 义 1 対応 アプ リ ケー シ ョンを 作成し 
てくだ さい。 


〇  C まとめ J 


本書で 提供す る 開発 環境は、 先人たち の 積み上げ てきた X680X0 と SX- 
WINDOW  に対する 理解と 情熱の 集大成と もい えます。 とっ つきに く かっ 
た 生の 解析 情報は かみ 砕かれ、 消化され たおで へッ ダ や ライ ブ ラリ のな 
かに 吸収され ま した。 

次章からは、 実際に これらを どのように インストールし、 使用す るか 
についての 解説を 行います。 インストールが 完了し、 それぞれの 環境の 
概要が 頭に 入った ところで スター トライ ン となる わけです が、 ゴールへ 
の 道のり は 決して 遠く はない はずです。 

さあ、 窓を 開けて SXer への 一歩を 踏み出しましょう。 
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本章では、 添が FD じ 収められた 郎 
榮舞 境の インストール 方法と CD- 
ROM  ドライバの 設ま 方法、 および 添 
が CD— ROM に 取 [録 されて いる SX - 
WINDOW が 応スリ ー ソフトの イン 
スト ー ル 方法に ついて 紹介 します。 


獅ぶ姑 . I 


Chapter  2 インストー ル 


本書には、 SX-WINDOW 用の アプリ ケー ショ ンを 開発す るた めの 基 
本 的な プログラムを 収めた フロッピーディスク （FD) と、 SX-WINDOW 
用に 作られた フリ ーソフ ト などを 収めた CD-ROM が 添付され ています。 

本節では、 そのう ちの FD 内に 収められた ファイルを ハー ド ディ スク 
じイ ンス トールす る 方法に ついて 説明し ます。 


FD から 実際に インス トールを 始める 前に、 必要な 環境 設定 や ハード 
ディスクの 容量な どを 確認して おき ま しょう。 説明を よく 読んで インス 
卜 ー ルの 準備を してく ださい。 

t 何を インストールす るか 

添付 FD に 収録され ている 「SX-WINDOW  ver.3.lP 谓発 ネット」 は、 り^ 
下の 4 つの パッケージから 構成され ています。 

(1)  SX31KIT ライブラリ パッケージ 

SX-WINDOW  ver.3.0/3.1 で 追加 さ れた マネ ージャ に 対応 した イン 
クルー ド ファイル や ライブラリ ファイルが 含まれて います。 

(2)  callno  header イ ン ライ ン ヘッダ パッケージ 

X680x0  gcc の SXCALL 機能を 用いて、 高速 かつ コン パク トな 実行 
ファイルを 生成す るた めの イ ン クルー ド ファ イノ/レが 含まれて いま 
す。 SX-WINDOW  ver.3.1 に 対応 しています。 

(3)  LIBSXC ライブラリ パッケージ 

Human68k 上の フ リーの ANSI  C 準掷 ライ ブラ リ である LIBC を 
SX-WINDOW に 対応 させた もので、 LIBC 上位 互換の イ ン クルー 
ド ファイル、 ライブラリ ファイル などが 含まれて います。 
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(4)  LIBSXC ソース コード パッケージ 

LIBSXC のす ベての ソー スコー ドが 含まれて います。 

なお、 


SX31KIT を 利用す るた めじは Workroom が 必要 


です。 

添 か FD には、 「SX-WINDOW  ver.3.1 關発 キット」 専用の イ ン ストー 
ラを 2 つ 用意し ま した。 

1 つは  INSTALL.BAT  で、 SX31KIT,  callno  header,  LIBSXC  の 3 つ 
の ハ。 ッ ケージを イ ンス トールす るた めの ものです。 これら 3 つの パッ ケー 
ジの 間には 若干の 依存性が あるた め、 個別に イ ンス トールす るのは 面倒 
であり、 かつ ミスを 引き起こす 可能性が あります。 本書では、 これら 3 
つを 「推奨 開発 環境」 としてい ますので、 じ I 降、 これら 3 つを 同時に イ 
ンス トールす る ものと して 説明 を 行います。 

もう 1 つは INSTSRC.BAT で、 LIBSXC ソー スコー ド パッケージを イ 
ン ストール する ための ものです。 この ソースコード パッケージは、 前述 
の 「LIBSXC ライブラリ パッケージ」 の ソース コー ドー 式を 収めた もので 
す。 通常の 使用では ソースコードは 不要な ため、 インストーラを 別に 用 
意し ま した。 

0 どこに インストー ルす るか 

次に、 インス トールに 必要な ディ スク 容量を 確認し ます。 

それぞれの パッケージを イ ンス トールす ると、 おおむね Table  2-1 じ 
示した ディスク 容量を 専有し ます。 インストール 先の ディスク じ、 イン 
スト ー ルしたい パッケージの イ ン スト ー ルに 必要な サイ ズじ I 上の空き 容 
量が ある ことを 確認して ください。 また、 callno  header を インスト ー 
ルす るには、 ノ 、。ッ ケージの 容量に I 外に、 0.2M バイ ト 程度の 作業領域が 必 
要です。 


化 ble  2-1 • インストール じ 必要な ディスクを 量 


/ く、'' ケージ 

ディスク 容量 

SX31KIT ライブ ラ リパッ ケージ 

callno  header イン ライ ン ヘッダ パッ ケージ 

LIBSXC ライブ ラ リパッ ケージ 

LIBSXC ソース コー ドパッ ケージ 

0.5M バイト 

0.2M バイト （  +  0.2M バイト） 
1.0M バイト 

3.5M バイト 
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D'Twen  巧 One.X" は、 
Ext  (川 本琢 二） 氏 作 
の フリーソフト です。 
本を の 添付 FD 内に 
"TWONE.X" という ファ 
イル 名に リネームされ 
て 収録され ています。 


たとえば、 本書の 推奨 開発 環境の みを インストール する 場合、 SX31KIT, 
callno  header,  LIBSXC の 3 つです から、 約 1.7M バイ トの 空きを 量が 
必要と なります。 

これらの パッケ ージを 用いて SX-WINDOW 開発 環境を 構築す るた め 
には、 SX-WINDOW  ver.3.1 システムの ほかに 泛 cc あるいは XC などの 
コンパイラ や、 アセンブラ、 リン々 といった ツールが 必要で あり、 フロ ッ 
ピー ディ スク ベースでの 構築は 困難です。 

したがって、 本書では ハー ド ディ スク 上での 構築を 行う こと を 前提と 
します。 コ ンパ イラな どを 含めた 開発 環境 一式を ハー ド ディスクに イン 
ストール する 場合、 約 20M バイ ト 程度の 空き 容量が あれば 十夕 収まる と 
思います。 最近では、 数百 M バイ トの ハードディスクが 非常に 安く 手に 
入れられ るよう になって きています ので、 この 機を に 大きめ の ハー ド ディ 
スクを 用意され てはい かがで しょう か。 

0 必要な 環境の 準備 

SX31KIT,  callno  header,  LIBSXC パッケージを イ ンス トールす るに 
は、 X680x0  gcc あるいは XC が 動作す る だけの 環境が 整って いれば、 特 
に 新しい 環境の 設定は 必要 あり ません。 

ただし、 LIBSXC ソースコード パッケージの インストールには、 特別な 
環境の 設定が 必要です。 ソースコード パッケージ 内の ファイルには、 長い 
ファイル 名を 持つ ものが 含まれて おり、 通常の 環境で インス トールす ると 
ファイル 名が 重複して 正しく イ ンス トールで きない ことがあり ます。 その 
ため ソ ー スコ ー ドノん ソケ ー ジをイ ン スト ー ルす る 前に、 フ ァイ ル 名 として 
21 文字す ベて 認識させる ことができ る プログラム "TwentyOne.X" りを 
常駐させる 必要が あり ます。 ソース コー ド パッケージの イ ンス トールに 
必要な "TwentyOne.X" や 環境 設定に ついての 詳しい 説明は、 「LIBSXC 
ソース コー ド パッケージの イ ンス トール」 （P.46) であらた めて 斤い ます。 

) ( ライブラリ パツケ ージの インストール 5 


イ ンス トールの 準備が 整ったら、 いよいよ インス トール 作業を 斤い ま 
す。 説明を よく 読んで、 間違いの ないよう にを 意して ください。 
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2-1 添付 FD からの インス K— ル 


0 インストーラの 起動 


2)  "COMMAND.  X" や" FISH. 


X"， "KSH.X" など。 


3) インス トーラ 【こ 使われ 
てし、 る  cat . X,  cp.x, 
mv.x,  rm.x の フル ア 
—ヵ イブは、 添せ CD- 
ROM の ¥OMAKE デイ レ 
ク トリ じ 収録され てい 
ます。 


まず、 X680x0 本体の 電源を入れ、 Human68k の コマンド シ卫 ル2) を 起 
動し ます。 なお、 添付 FD じは システムが 入って いないので、 直接 FD か 
ら 起動で き ません ので 注意して く ださい。 

もし SX- WINDOW 力ぶ 起動して いるよう であれば、 一度 終了 させて コ 
マン ドライ ンに 戻る か、 "COMMAND. X" の アイ コンを ダブル クリックして 
コマン ドシェ ノレを 起動して く ださい。 SX-WINDOW から インストー ラ 
を 実行す る ことは できません。 

次に、 添付 FD を 用意し ます。 安全の ため、 必ず バックアップを 取り、 
バックアップした フロッピー ディスク （U 下、 インストール ディスクと 
呼ぶ） を 使用す るよう にして ください。 インストール ディスクを 用意し 
たら、 X680x0 本体の フロッピー ディスク ドライブの 〇番じ 挿入し、 々レ 
ント ドライブを、 イ ンス トール ディ スクを 挿入した ドライブ じ 変更して 
ください。 

たとえば、 インストール ディスクを 挿入した ドライブが C ドライブ であ 
れ ば、 次のように キー ボー ドから 入力し ます。 画面の 表示 例 中の 「A:¥>」 
という 表示は コマン ドシ X ルの プロ ンプト です。 

^  A:¥>  C:  ) 

次に インス トー ラ3) を 起動し ます。 次の よう に 入力して く ださい。 

^  C:¥>  INSTALL.BAT  j 

イ ンス トー ラが 正常に 起動す ると、 順次 画面に メ ッ セージが 表示され 
ます。 必要に応じて、 インストーラが 設定 巧 目につい てたず わたり、 確認 
を 求める ことがあります ので 適切に 回答して ください。 なお、 メッセ ー 
ジ 中の" CTRL+C" とは、 に TRL] キーを 押しながら [C] ネーを 押す こと 
を 意味 します。 

イ ンス トー ラを 起動した 際に、 「(失 臘 環境 変数 temp が 定義され てい 
ないよう です。 テンポラリ ディ レクト リ の フルパスを 環境 変数 temp に 
設定して 下さい。」 と 表示され た 場合は、 適当な ドライブ （たとえば、 A 
ドライブ） に 適当な 作業用 ディ レクト リ げ TEMP) を 作り ます。 そ して、 コ 
マンド シェルから 「set  te 皿 p=A:¥TEMP」 のように 入力して から、 イン 
ス トー ラを 起動して く ださい。 
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<9>  インストー ラを 終了す る。 

1 から 7， あるいは 9 のうち、 どれ かひと つを 選択して くピ さい。 

(回答） > 

V _ J 

まず、 インストール する パッケージを 選択して ください。 たとえば、 す 
ベての パッケージを インストール するなら 「1」、 SX31KIT のみなら 「4」 
を 入力し ます。 

本書では、 3 つ すべてが そろった 環境を 推奨 開発 環境と してい ますの 
で、 じ I 降、 「1」 を 選択した 場合に そって 説明し ます。 「1」 り I 外を 選択し 
た 場合は、 適宜、 該当 部分 外の 説明を 読み 飛ばして ください。 

0  SX31KIT の インスト ール 

まず、 インストール 先の ディレクトリ 名を 入力し ます。 インストール 
先の ディ レクト リ には、 なるべく 何もない 新しい ディ レクトり を 指定し 
てく ださい。 イ ンス トール 先にす で じ ファイルが ある と インス トー ラが 
誤動作す る こと があります。 


幸 幸 幸 幸 幸 本 幸 幸 幸 幸 幸 幸 幸 幸 幸 幸 幸 幸 幸 本 幸 幸 本本 キ幸 ♦幸 幸 幸 幸 幸 幸 幸 幸 幸 本 幸 本 幸 幸 幸 幸 本 幸 幸 本本 幸 本本 本本 本本 本 幸 ネ本幸 幸 

*  SX-Window3. 1  Develop  Kit  -  Install  Script  * 

幸 本本 幸 本 幸 幸 本本 幸 幸 幸 幸 本 幸 本 幸 本本 幸 幸 幸 本 幸 幸 幸 幸 幸 幸 幸 本本 本本 幸 本本 本本 幸 本本 幸 本本 幸 本本 幸 幸 幸 幸 幸 幸 幸 本 幸 幸 本本 幸 

今から 付属 フロ ッ ピー ディスクの インス トー ルを 斤ない ます。 

質問に 正しく 答えて く ださし、。 

(質問） 付属 フロッピー ディスク のうち， どれを インストール します か？ 

A.  SX31KIT ライブラリ パッ ケージ （空き 容量が 0.5MB 必要です） 

B.  CALLN0 インライン ヘッダ  （空き 容量が 0.2MB 必要です） 

C.  LIBSXC ライブラリ パッ ケージ （空き 容量が 1.0MB 化 要です） 


do  1  〇  1  〇  !  〇 

を 〇  ~  1  〇〇  i 

も 00 〇 i  ~  一 

>>>>>>> 
1  2  3  4  5  6  7 
<<<<<<< 


2-1 添付 FD からの インス -ー ル 


それでは 「SX31KIT ライブラリ パッケ ージ」 を インストー ルし ます。 

(質問） どこに インストール します か？ 

インス トール 先の ディ レクト リ 名を フルパスで 入力して 下さい。 

ただし パスの 最後に ¥ や/ をせ けないで 下さい。 

中断す るには CTRL+C を 押してく ださし、。 

(回答） > 

V _ J 

たとえば、 A ドライ ブの 「¥usr¥lang」 という ディ レクト リに インス 
トールす る 場合は、 次の ようじ 入力し ます。 なお、 ディレクトリ 名の 最 
後に" ¥ "や"/" などの ハ °ス 区切 り 記号を つけない よ うにして く ださい。 

(回答） - >  A :¥iisr¥laii 居 

もし、 インストール 先の 空き ディスク 容量が 足りない 場合、 インスト ー 
ラは 次の ような メ ッ セージを 出力 して 実行を 中断し ます。 空き 容量を 再 
確認 したの ち、 最初 か ら インストールを やり直して ください。 

(菩 告） 指定した ディレクトリ じは 「SXSIKIT ライブラリ パッ ケージ J を 
イ ンス トールす る だけの 空き 容量が あり ません。 

もう 一度 確認 して 最初 か ら インストールを やり直して ください。 


C:¥> 


次に Workroom が 正 しく イ ン スト ー ル さ れて いるか どう かを 權認 しま 
す。 ここでは、 インストール 先が 空で ある ことを 想定して いますので、 次 
のよう なメ ッ セージが 表示され ます。 


Workroom の インス トー ルを 確認し ます。 NG . 

(警告） Workroom が 正しく インスト ー ルされ ていません。 

(質問） Workroom を インストー ルし ます か？ 

イ ンス トールす るなら y、 

しないなら n を 入力して 下さし、。 


(回答） 一 - > 


SXSIKIT を 利用す るた めには Workroom が 必要です ので、 まず、 Work- 
room を インストールして ください。 ここでは 「y」 を 入力し ます。 
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(確認） Workroom を インストー ルし ます。 

ドライブ I じ Workroom アプリ ケーシ ヨン ディスクを 挿入した 後、 
リ ター ン キーを 巧して 下さし、。 


フロッピー ディスク ドライブの 1 番に Workroom アプリ ケー シ ヨン 
ディスクを 挿入した あと、 リターン キーを 押してく ださい。 Workroom 
のうち、 必要な ファイルが 自動的に インス トールされ ます。 

^  Workroom を A :  /usr/lang  (こ インストー ルし ます。 

Workroom の インス トー ルが 終了す ると、 SX31KIT の インス トールを 
斤い ます。 


r  、 

それでは 「SX31KIT ライブラリ パッケ ージ」 を インストー ルし ます。 

Mode  Size  Date  Tune  Name 

d-rwx  0  95-02-04  11:49:24  A : /usr/lang/INCLUDE/ 

-arw-  9598  95-01-08  12:00:00  A : /usr/lang/INCLUDE/COLOR . H 

-arw-  2604  95-0い08 12:00:00  A : /usr/lang/INCLUDE/MENU . H 

-arw-  36457  95-01-：26  01:37:42  A : /usr/lang/INCLUDE/SXGRAPH . H 


中略 


-arw-  26882  95-01-08  12:00:00  A : /usr/lang/INCLUDE/SXCALL .MAC 
-arw-  42911 95-〇い：26  01:37:40  A:  /usr/lang/ INCLUDE/SXCALL.H 
d-rwx  0  95-02-04  11:49:26  A: /usr/lang/LIB/ 

-arw-  25740  95-01-08  12:00:00  A : /usr/lang/LIB/LIBSX3 . A 

Total  282701  16  files 

終了し ました。 


じ [上で SX31KIT のイ ン スト ー ルは 終了です。 


callno  header のイ ン スト ー ル 
まず、 callno  header のイ ンス トール 先を 確認し ます。 

r 

それでは 「CALLNO インライン ヘッダ」 を インストー ルし ます。 

(確認） インスト ー ル 先は A :  /usr/lang でよ いです か？ 

よければ "y"、 別の バス じする 場合は" n" を 入力して 下さし、。 

(回答） > 


本書 付属の イ ン ストー ラは、 3 つの パッケ ージを 同じ デイ レクト リにイ 


2-1 添付 FD からの イ ンス トール 


ン ストール する ことを 前提に しています ので、 ここでは 原則として 「y」 
を 入力して ください。 ここで 「打」 と 入力した 場合、 もしくは callno 
header のイ ンス トールを 斤わない 場合、 イ ンス トール 化の ディ レクト リ 
を 入力す る 必要が あります。 詳しくは 「SX31KIT の インストー ル」 （P.38) 
を 参照して ください。 

もし、 インストール 先の 空き ディスクを 量が 足りない 場合、 インスト ー 
ラは 次の ような メ ッ セージを 出力 して 実行を 中断し ます。 空き 容量を 再 
確認した のち、 最初から インス トールを やり直し てく ださい。 


(警告） 指定した ディレクトリ じは 「CALLN0 インライン ヘッダ」 を 
インス トー ルす るた •けの 空き 容量が あり ません。 

もう 一度 確認して 最ネ 刀から インス トールを やり直し てく ピ さし、。 


callno  header の インス トール じは、 別途 作業領域が 必要に なり ま 
す。 環境 変数 temp に、 作業領域 として 200K バイ ト 程度の 空き 容量が あ 
る ディ レクト リを 設定し ます。 作業領域の 空き 容量が 足リ ない 場合、 イ 
ンス トー ラは 次の ような メッセージを 出力して 実行を 中断し ます。 空き 
容量を 额隹認 したの ち、 最初から インス トールを やり直して ください。 


(警告） テンポラリ ディレクトリ じ 「CALLNO インライン ヘッダ」 を 
インス トー ルす るた めの 作業領域が 確保で きません。 

テンポラリ じ 200k が 上の空き 容量を 確保して から、 

インス トー ルを やり直し てく ピ さい。 


C:¥> 


次に Workroom および SX31KIT が 正しく インストール されて いるか 
どうかを 石舊認 します。 もし、 正しく インストールされ ていない 場合、 イ 
ンス トー ラは 次の ような メ ッ セージを 出力 して 実行を 中断し ます。 空き 
容量を 再 確認した のち、 最初から インス トールを やり直し てく ださい。 

Workroom および SX31KIT のへ ツ ダを 確認 します。 

(警告） Workroom も' よび SX31KIT が 正しく インストー ルされ ていません。 

このままで すと、 Workroom わよ び SX31KIT からは CALLNO を 利用 
でき ません。 


ヘッダ’ の 確認が 終了 すると、 callno  header の インスト ー ルを 始め 
ます。 
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Chapter  2 インストー ル 


4) CONFIG. SYS  中の FIL 
ES の 値が 小さい と、 
callno  header  のイ 
ンス トー ルの 途中で 止 
まること があります。 
その 場合は FILES の 
値を 大きく した 後、 ィ 
ンス トー ルを やり直し 
てく ピ さい。 


それでは 「CALLN0 インライン ヘッダ J を インストー ルし ます。 

テンポラリ じ 展開し ます。 

インライン ヘッダを インス トールし ます。 

Workroom わよ び SXSIIQT の ヘッダ じ パッチを あてます。 

中略 

終了し ま した。 

\ _ J 

これで、 callno  header のイ ンス トールは 終了です4)。 

A  LIBSXC の インスト ール 

まず、 LIBSXC の インストール 先を 確認し ます。 

それでは 「LIBSXC ライブラリ パッケージ」 を インストー ルし ます。 

(確認） インストー ル 先は A:/usr/lang でよ いです か？ 

よければ "y"、 別の パス じする 場合は" n" を 入力して 下さい。 

(回答） --- > 

V  _ J 

本書 付属の イ ンス トー ラは、 3 つの パッケージを 同じ ディレクトリに イ 
ン ストール する ことを 前提 じして いますので、 ここでは 原則として 「y」 
を 入力して ください。 ここで 「n」 と 入力した 場合、 もしくは LIBSXC の 
インス トールを 斤わない 場合、 インス トール 先の ディレクトリ を 入力す 
る 必要が あ ります。 詳しくは 「SX31KIT の インス トール」 （P.38) を 参照 
してく ださい。 

もし、 インストール 先の 空き ディスク 容量が 足りない 場合、 インスト ー 
ラは 次の ような メ ッ セージを 出力 して 実行を 中断し ます。 空き 容量を 再 
確認した のち、 最初から インス トールを やり直し てく ださい。 
f  \ 

(警告） 指定した ディレクトリ じは 「LIBSXC ライブラリ パッ ケージ J を 
インス トールす る だけの 空き 容量が あり ません。 

もう一度 確認して 最ネ 刀から インス トールを やり直し てく ださい。 

V  _ J 

空き 容量の 確認が 終了す ると、 LIBSXC のイ ン スト ー ルを 始めます。 
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2-1 添付 FD からの インス トール 


それでは 「LIBSXC ライブラリ パッケ ージ」 を インストー ルし ます。 


Mode 

Size 

Date 

Time 

— arw— 

36394 

94-11-28 

01:31:28 

— arw— 

14 已 3 

94-12-15 

19:44:10 

-arw— 

1970 

94-11-27 

22:00:56 

d-rwx 

0 

94-05-02 

21:38:04 

d-rwx 

0 

94-05-02 

21:41:18 

—arw— 

788 

93-10-07 

01:11:08 

—arw— 

7293 

94-12-15 

15:18:54 

中略 

— arw— 

1732 

94-11-28 

00:56:58 

-arw- 

3960 

94-11-28 

00:57:08 

— arw— 

11596 

94-11-28 

00:58:26 

—arw— 

132 

94-11-28 

00:58:32 

— arw— 

2872 

94-11-28 

00:58:% 

— arw— 

4720 

94-11-28 

00:58:54 

—arw— 

Total 

144622 

752037 

94-12-15 

18:44:36 

Name 

A: /usr/lang/CHANGELOG 
A: /usr/lang/ChangeLog . SX 
Ar/usr/lang/README 
A : /usr/lang/ include/ 

A : /usr/lang/ include/ sys/ 

A: /usr/lang/include/sys/dir . h 
A:  /usr/lcing/ include/ sys/dos .  h 


A : /usr/lang/lib/libprof . a 
A : /usr/lang/lib/libscsi . a 
A: /usr/lang/lib/libsignal . a 
A : /usr/lang/lib/libsuper . a 
A : /usr/lang/lib/libtz . a 
A: / usr/lang/lib/libw . a 
A : /usr/lang/lib/libsxc . a 
118  files 


LIBSXC と Workroom を 同時に 利用す る 場合、 Workroom の SXLIB.L 
から いくつかの オブ ジ卫ク トフ ァイ ルを 削 際しなければ なり ません。 削 
除 作業は、 インストーラが 自動的に 斤い ます。 


LIBSXC で Workroom (SXLIB) を 利用す る 場合、 そのままでは リンク 時に 
シンボルの 衝突が 起きます。 これを 防ぐ ため、 が 下の オブジェクトを 
SXLIB から 削除し ます。 

.OPEN . 〇  .CLOSE. 〇  _SXKC0MM.o  _SXOBJC.o 

V _ / 


じ I 上で LIBSXC の インス トールは 終了です。 


0 ライブラリ 形式の 選択 

本書の 推奨 開発 環境では、 すべての ラ イブ ラリ ファイルを A 民 形式 （ . A) 
に 統一して います。 もし、 あなたが XC に 付属して いる" LIB. X" を持っ 
ているならば、 これらを よ リ 高速に リ ンク する ことが 可能な LIB 形式 
(•L) に 変換す る ことができます。 

ただし、 LIBSXC がバー ジョン アップな どに よっ て 再配布 される 場合、 
つねに A 民 形式で 斤 われます ので、 なるべく  A 民 形式の まま 使用した ほ 
う がよ いでし よう。 
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Chapter  2 インス ル 


(質問） ライブラリを AR 形式 （.A) から、 高速な LIB 形式 （.L) じ 変換し ます 
か？ 

変換す るなら" y" を、 変換し ないなら" n" を 入力して ください。 

中断す るには CTRL+C を 押してく た •さい。 

(回答） > 

V _ J 

「y」 を 選が すると、 インストーラは あなたの 環境から" LIB.X’’ を検 
索し、 ライブラリを LIB 形式に 変換し ます。 もし" LIB.X" が 見つから 
ない 場合、 インストーラは 次の ような メッセージを 表示し、 ライブラリ 
形式の 変更を 行いません。 


(警告） LIB.X が 見つかりません。 

ライブラリは AR 形式 し A) のままで す。 


"LIB.X" の檢 索が 正常に 終了 した 場合、 インス トー ラは すべての ライ 
ブラ リファイ ルを LIB 形式に 変換し ます。 


ライ ブ ラリを LIB 形式 CL) じ 変換 します。 

変換 libsx.a  -- >  libsx.l 
変換 libsx3.a  — >  libsx3. 1 

中略 

変換 libw.a  — >  libw.l 
変換 libsxc.a  -- >  libsxc.l 

終了し ま した。 


0 ライブラリ 名の 選択 

本書の 推奨 開発 環境では、 ライブラリ ファイルの 名称が" libc.a" の 
ように XC の ライブラリ ファイル "clib.a" と 前後が 逆に なって います。 
X680x0  gcc でのみ 使用す る 場合は このまま でも かまいませんが、 XC か 
ら も 利用す るので あれば、 名称を XC 形式に 変更し なければ なり ません。 


44 


2-1 巧 巧 FD からの インス トール 


(質問） ライブラリの 名称を XC 形式に 変更し ます か？ 

"clib.a" という XC 形式の ライブラリ 名を 使用す るなら" y" を 
"libc.a" という LIBC 形 ホの ライブラリ 名を 使用す るなら" n" を 
入力して く ピ さし、。 


中断す るには CTRL+C を 押してく ださし、。 


(回答） > 


もし、 XC 形式へ 変更 するならば 「y」 を、 このままで よければ 「n」 を 
入力して ください。 

なお、 ライブラリを LIB 形式に 変更した 場合、 これの [降の 画面の 表示 
は". a" ではなく、 ".1" になります。 文中の 表示 例を 適宜 読み 換えて く 
ださい。 


ライブラリの 名称を XC 形 まじ 変更し ます。 

変換 libsx.a  — >  sxlib.a 
変換 libsx3.a  — >  sx31ib.a 

中略 

変換 libw.a  — >  wlib.a 
変換 libsxc . a  -- >  sxclib. a 

終了し ま した。 


>  AUTOEXEC . BAT の 含き 換え 

ここまでで ライブ ラ リ パッケージの イ ンス トールは 終了し ま した。 
最後に、 ここまでの インス トール 結果 じあ わせて 環境 変数を 設定す る 
ために、 あなたの システムの" AUTDEXEC.BAT" を 修正し ます。 ただし、 
インス トー ラは 設定 例を 出力す るの みで、 実際の 修正は あなたが 手動で 
斤って く ださい。 


最後 じこ こまでの イ ンス トール 結果に 合わせて 環境 設定を 巧い ます。 

A:/usr/lang じ AUTOEXEC .PLS の 名前で 設 をすべき 環境 変数と その 値 等を 
記した ファイルを 出力し ます。 その 内容に 従って あなたの AUTOEXEC.BAT 
(あるいは それに 相当す る もの） を 編集して 下さし、。 


インス トール 化の デイ レクト リに "AUTOEXEC.  PLS" という ファイル 名 
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で、 必要な 環境 変数の 一 鏡を 出! 力し ます。 これを 参考に して" AUTOEXEC. 
BAT" を エディ タ などで 修正して ください。 "AUTOEXEC  .PLS" の 出力 例を 
次に 示します。 


REM  义 下の 環境 変数が 設 をされ るよう じ、 あなたの AUTOEXEC.BAT を 

REM 編集して 下さし、。 

set  include=A:¥usr¥lang¥include 

set  lib=A :¥usr¥lang¥lib 

set  GCC_LIB=.a 

REM 環境 変数 GCC.NO.XCLIB が 設定され ない ことを かず 確認して 下さし、。 


"REM" で 始まる 斤は 注釈です ので、 削除して かまいません。 ただし、 
注釈に 書かれて いる 内容を よく 理解し、 確認して から 削除す るよう にし 
てく ださい。 

特に、 環境 変数 GCC_NO_XCLIB に関する 注釈は 重要です。 GCC_N0_XC 
LIB は、 他の 環境 変数と 違って、 変数の 内容では なく、 「設定され ている 
か 否か」 力ぶ 問題になります。 「設定され ない ことを 必ず 確認して 下さい」 
とを 釈 にある 場合には、 必ず GCC_NO_XCLIB が 設定され ない ことを 確認 
してく ださい。 

他の 環境 変数 （include ， lib,  GCC_LIB) について は、 AUTOEXEC.BAT 
内の 別の 場所で 内容が 上書き される ことのな いよう じを 意して ください。 
確実な 方法と しては、 これらの 環境 変数の 設定を AUTOEXEC.BAT の 一番 最 
後で 斤う とよいで しょう。 なお、 "AUTOEXEC  .PLS" の 出力は" COMMAND  .X" 
を シュルと して 使用して いる 場合を 想定した ものです。 "FISH  .X" や 
"KSH.X" を お使いの 方は、 各自で 適切な 書式に 変更して ください。 

/ 

インス トールは これです ベて 終わりです。 おつかれさまでした。 

c：¥> 

V _ J 

じ I 上で、 推奨 開発 環境に 必要な すべての パッケージの インス トールは 
終了です。 

( LIBSXC ソ ースコ -- ド パツケ ~ジ の インスト ~ ル ） 


ここでは、 「LIBSXC ソース コー ドノ、。 ッケ _ ジ」 の インストール じつい 
て 説明し ます。 ソースコード パッケージを インストール しない 場合は、 こ 
れじ I 降 50 ページまで 読む 必要は あり ません。 


2-1 添付ド0からのィンス[ -ー ル 


# 特別な 環境 設定 

「必要な 環境の 準備」 （P.36) でも 述べた ように、 ソース コード パ ッケー 
ジを 正し く インス トールす るた めには、 ファイル 名を 21 文字まで 正しく 
認識させる よう、 あらかじめ 環境 設定を 斤わなければ なリ ません。 

Human68k は、 ファイル 名を 21 文字まで 扱える にもかかわらず、 標準 
では そのうち 先頭の 8 文字まで しか 実際 じは 認識し ません。 そのため、 9 
文字 目の J をが 異なって いても 先頭の 8 文字が 同 じで あれば、 同じ フ ァイ 
ルで あると 誤 認識して しまいます。 ソース コー ド パッケージ 中の フ ァイ 
ルは 長い 名前が 多いた め、 そのままで はいく つかの ファイルが 上記の 理 
由で 上書きされ てし まいます。 

この 問題を 解決す るた めには、 "TwentyOne.X" という フリーソフト 
ウ卫ア を 利用し ます。 本ソフ トウ 卫アは 添付 FD に 収録され ています。 
ソース コー ド パッケージ 専用の イ ン ストー ラは、 自動的 じあな たの 環境 
(Human68k の バージ ョ ン など） を チェックし、 TwentyOne .  X を 適切に 組 
み 込む ための 手助けを します。 もちろん、 すでに 組み込まれ ている 場合 
には、 この 処理は 斤 われません。 


0 インストーラの 起動 


5) TwentyOne. X  は 動作 
時に メモリ じ 常駐し ま 
す。 


「インスト ー ラの 起動」 （P.37) の 場合と 同様にして インス トー ラ を 起動 
します。 ただし、 "INSTALL.BAT" のか わりに" INSTSRC.BAT" を 起動し 
てくだ さい。 

^  C:¥>  INSTSRC.BAT  j 

インスト ー ラが 正常 じ 起動す ると、 まず "Twe 丘 tyOne  .X" の 常駐 チェ ッ 
ク 5) を 行います。 


本本 幸 本本 ネ幸 本本 幸 幸 幸 幸 ♦★本本 幸ネ 本本 幸 幸 幸 幸 幸 幸 本 幸 本本 幸 本本 幸 幸 幸幸ネ ★★幸 幸 幸 幸 幸ネ幸 ★本 幸 幸 幸 ネネ 幸 幸 ネ本幸 本 

キ  LIBSXC  Source  Code  Package  —  Install  Script  ♦ 

本 ♦本 幸 幸 幸 本本 本 幸 本本 幸 本 ★本本 本 幸 幸 幸 ♦幸 本本 本本 幸 本本 幸 幸 ★幸 幸 本 幸 幸 本本 本 ★幸 幸 幸 幸 幸 本本 本本 本 幸 幸 本本 本 幸 幸 本本 

今から 「LIBSXC ソース コード パッケ ージ」 の インストー ルを 行ないます。 
" Twenty  One.  X" の チて ツク をし ます。 


"TwentyOne  .  X" が 正しく 常駐して いた 場合、 「インスト ー ル 先の 指定」 
(P.48) に 進んで ください。 "TweirtyO 打 e  •  X" が 組み込まれ ていない 場合、 
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次の ような メッセージが 表示され ますので、 "TwentyOne.X" を インス 
トールす る デイ レクト リ 名を 入力して く ださい。 


(確認） あなたの 環境には "TwentyOne.X" が 使用され ていません。 

ソ ー スコ ー ド パッケ ー ジ を 正 しく インスト ー ルす る 【こは、 この 
プロ グラ厶 を インス トー ルす る 必要が あり ます。 

(質問） "TwentyOne.X" を どの ディレクトリ じ インストール します か？ 
インス トール 先の ディ レクト リ 名を フルパスで 入力して 下さし、。 
ただし パスの 最後に ¥ や/ を 付けないで 下さい。 

中断す るには CTRL+C を 押してく ピ さし、。 

(回答） > 


たとえば、 A ドライブの "¥sys" という テ'‘ ィ レクト リ にイ ンス トール 
する 場合は、 次のように 入力し ます。 

I  (回答) - >  A:¥sys  I 

インス トー ラは 指定され た ディ レクト リに "TwentyOne.X" をコ ピー 
したの ち、 次の ような メ ッ セージを 表示して 実 斤を 中断し ます。 


あなたの CONFIG.SYS じ 

DEVICE  =  A : ¥sys¥TwentyOne . X  +TS 

の I 行を 加えた のち、 リセ ツ ト ボタンを 押して 再起動して 下さい。 

正常 じ 起動 したら、 も う一 度最 ネリから ソー スコー ド パッケ ージの 
インス トー ルを やり直して 下さい。 

C:¥> 

^ _ J 

メ ッ セージに 従って CONFIG.SYS を 書き換え たのち、 リセット して か 
らもう 一度 インス トー ラを 起動して ください。 


0 インス トール 先の 指定 

ソースコードを インス トールす る ディ レクト リ 名を 入力し ます。 


2-1 滿付 FD からの インス トール 


(質問） ソースコードを どこに インストール します か？ 

インス トール 先の デイ レクト リ 名を フル バスで 入力して 下さし、。 
ただし パスの 最後に ¥ や/ を 付けないで 下さい。 

中 斬す るには CTRL+C を 押してく ピ さい。 


(回答） > 

V _ J 

たとえば、 A ドライブの ‘‘¥usr¥laiig’’ という ディレクトリに インス 
トールす る 場合は、 次のように 入力し ます。 ディレクトリ 名の 最後に" ¥" 
や"/" といった パス 区切り 記号を つけない ようじし てく ださい。 

なお、 LIBSXC の ライブ ラ リ パッケージと ソー スコー ド パッケージは 
別々 の ディレクトリ じ インス トールす る こと も 可能です が、 極力、 同じ 
ディ レクト リに インス トールす るよう にして く ださい。 

I  (凹 答 J - >  A:¥usr¥lang  | 

もし、 インストール 先の 空き ディスク 容量が 足りない 場合、 インスト ー 
ラは 次の ような メ ッ セージを 化 力 して 実 斤を 中断し ます。 空き 容量を 再 
確認した のち、 最初から インス トールを やり直し てく ださい。 
f  \ 

(警告） 指定した ディレクトリ じは 「LIBSXC ソース コード パッケ ージ」 を 
インス トール するどけ の 空き 容量が あり ません。 

もう 一度 確認 して 最初から インストールを やり直して くださし、。 


C:¥> 


空 き 容豐の 確認が 終了 すると、 ソ ー スコ ー ドの イ ン スト ー ルを 始め ま 
す。 環境に もより ます 力ぶ、 すべてを イ ン ストールす るには 数 かを 要します。 
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Chapter  2 インストー ル 


それでは 「LIBSXC ソース コード パッケ ージ」 を インストー ルし ます。 


Mode 
-arw- 
— arw— 
-arw— 


Size  Date  Time  Name 
36394  94-11-28  01:31:28  a : /usr/lang/CHANGELOG 
1453  94-12-15  19:44:10  a : /usr/lang/ChangeLog . SX 
1970  94-11-27  22:00:56  a: /usr/lang/README 


中略 


— arw— 
-arw- 
-arw- 
Total 


1242  94-11 づ 6  23:50:16 
1549  94-11-%  23:50:24 
1497  94-12-15  15:50:00 
1230613 


a: /usr/lang/src/Def aultRules 
a: /usr/lang/src/Makeii 丄 e 
a: /usr/lang/src/Makef lie . SX 
1069  files 


終了し ま した。 


C:¥> 


じ [上で LIBSXC ソース コー ド パッケージの イ ンス トールは 終了です。 
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2-2 添 巧 CD-ROM からの インス トール 


本節では、 本書の 添付 CD-ROM に 収められた フ リー ソフト ウ卫ア 似 
下、 フリーソフト） を、 SX- WINDOW 上で 動作す る インストー ルプ ログ 
ラムを 使って ハー ド ディスク 等に インス トールす る 方法に ついて 説明し 


ます。 


添が CD— ROM について 


は じめ に、 添付 CD-ROM の 内容と 取り扱い 上の 注意点に ついて 簡単 


じふれ て おきます。 


0 収録 内容 


1)  ソフ トウて アを 継続し 
て 使う 場合には 定めら 
れた 金額を 作者に 寄せ 
する 必要が あります。 

2)  CD-ROM の 記録 方法 や 
ファイルシステム とし 
ての フォーマット を定 
めた 規格の I つ。 レべ 
ル I では、 ファイル 名 
じ 使える 文字は "A-Z、 
0-9、 _  (アン ダー ハ •一 )" 
のみと 規 をされ てい ま 
す。 


3) CD-ROM デバイス ドラ 
ィバを わ 持ちで ない 場 
合は、 後述の インスト 
— ル 方 まじ 従つ て; 素せ 
FD じ 収録され ている デ 
バイス ドライバを 組み 
込んで から ご 利用く だ 
さし、。 


本書の 添付 CD-ROM じは、 添付 FD にも 収録した 「SX- WINDOW 
ver.3.1 開発 キット」 の ほかに、 現在 大手 BBS などで 公開され ている SX- 
WINDOW 対応 フ リー ソフト （一部 シュア ウュア 1) も 含まれる） の ほ とん 
どと、 C コ ンパ イラな ど SX— WINDOW アプリ ケー ショ ン 開発に 必要と 
思われる Human68k 対応 フリー ソフ トを 厳選して 収録いた しま した。 

特に SX-WINDOW 用フ リー ソフト について は、 ソフ トウ エア 作者の 
方々 の ご協力を 仰ぎ、 可能な かぎり ソースファイル も 含めて 収録いた し 
ま した。 これから SX-WINDOW の アプリ ケー ショ ン 開発を 始めようと 
いう 人の よき 指針 として 活用して いただければ 幸い です。 

また、 添 か CD- ROM は ISO9660 レベル 1 規格 2) に従っ た フォー マッ 
卜 で 作成 さ れ ており、 X680x0 シ リーズと CD-ROM ドライ ブを 用意して 
いただ ければ、 誰でも 利用す る こと がで きます3)。 

0 巧 用 許諾 条件 

添付 CD- 民 OM は、 U 下の 使用 許諾 条件に f 走って ご 利用く ださい。 
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Chapter  2 インストー ル 


4) シェアウェア や SX31 
KIT,  ca 丄 Ino  header, 
添付 FD のなかでは 計 
測 技研 提供の CD-ROM 
デバイス ドライバが こ 
れ じあたり ます。 


〇 添付 CD-ROM に 収録され てい る フリーソフトは、 それぞれの ソフ 
トウて ア 作者なら びに 提供 元が その 著作権を 有して います。 各ソ 
フ トウて アの 使用 許諾 条件、 再配布 条件に ついては、 ソフト ウュア 
に 付属す る ドキ ュメン ト 類に 記載され ています ので、 ご 使用に な 
る 前に 必ず お読みく ださい。 特に、 フリーで ない ソフトウェア4) に 
ついては、 その 使用に 制限が あります ので、 提供 元が 定める 使用 
許諾 事竭 にを 意して ください。 

〇 添イ寸 CD-ROM に 収録され ている ソフト ウ卫ア について、 作者は も 
とより、 ソフトバンク ならびに 筆者ら は、 ソフト ウ卫ア の 品質、 機 
能 および 性能に ついて なんら 保証す る ものでは あり ません。 筆者 
ら は、 これらの ソフ トウ 卫アの 4 义録に 際して 簡単な 動作 確認を 斤つ 
てい ます 力ぶ、 動作の 結果に 対して いかなる 種類の 保証 もいた しま 
せん。 


0 収録 ソフトウェア 

添付 CD-ROM に 収録され た ソフト ウ卫ア は、 ソフト ウ卫 ア 作者の 方々 
の ご 厚意に よ り 収録を 許可して いただいた ものです。 ソフ トウ 卫ア によっ 
ては 開発 途中の もの もあります が、 今後の バージョンアップ などの サ ポー 
卜 について 筆者ら ならびに ソフ ト バンクは いっさい 関み しません。 バー 
ジョ ン アップ や 質問に ついては、 APPENDIX 〔章 「SX-WINDOW フリー 
ソフト ー覧」 （P.171) に サポート ネットと して 巧 記されて いる パソコン 通 
信 ネット ワークに おいて 各自で 対応して いただく こ とに なり ます。 

の のを 意 事項を 守って いただい たう えで、 添が CD-ROM を 大いに 
活用して ください。 

それでは、 添付 CD-ROM に 収められた ソフ トウ ユアの インストール 
方法 じついて 順次 説明し ま しょう。 


CD-ROM デバイス ドライバの インスト"ー ル 


9  CD-ROM デバイス ドライ/く 


52 


Human68k  ver.3.02 は、 標準では CD-ROM デ バイ スがサ ポー ト され 


2-2 添 巧 CD-ROM からの イ ンス トール 


5)  製品 版の 売りの ひとつ 
である オーデ イオ コマ 
ン ドの 機能が 省略され 
ています。 

6)  ディスク 内容の 整理 
をす る ことで アクセ 
ス 速度を 向上させる 
"refreshg.yi •や、 グ 
ラフィック 表示 プ ログ 
ラ厶 apicg.r などの 
作者。 


7)  SUSIE は、 SCSI デ バイ 
スの ための 多 機能 デ 
バイス ドライ バ で、 

1995年7月13日 時点で 
の 最新 版は SSE_107A 
.LZH です。 

8)  SUSIE  では、 PC-98 や 
旧 M  PC/AT 互換 槪 FM 
TOWNS  用の  CD-ROM 

ドライブ も 認識で き 
るよう です が、 どんな 
CD-ROM ドライブ でも 
必ず 認譜 できる わけで 
はない 点じを ちして く 
ださい。 

9)  も しち 人に 旧 M  PC/AT 
互換 機 や PC- 98、 FM 
TOWNS を わ 持ちの 方が 
わられたら、 それらの 
マシンに CD-ROM ドラ 
イブを 接続して フ アイ 
ルを 取り出す こと もで 
きます。 


ていません。 そのため、 本書 添付の CD-ROM に アクセスす るた めには、 
サード パーティの 製品 や フリー ソフトと して 公開され ている CD-ROM デ 
バイス ドライバを 別途 組み込む 必要が あり ます。 

本書の 添が FD には、 1.2  (株) 計測 技研の ご 厚意に よ り 提供して いただ 
いた 機能 限定版 CD-ROM デバイス ドライバ 5)"cddev.sys" と、 後藤 浩 
昭 (GORRY) 氏6) 作の フリ ーの 多 機能 SCSI デ バイ ス ドラ イノく  SUSIE7) を 
収録して います。 

本書の インス トール 解説では、 計測 技研 提供の 機能 限定版の cddev.sys 
の 組み込みを 前提と してい ますが、 cddev.sys を 組み込んでも CD-ROM 
ドライブが 認識され ない 場合は、 後者の SUSIE を 組み込ん でから お試し 
く ださい8)。 いずれの デ バイ ス ドライ バを 組み込んでも 認識で き ない 場 
合は 誠に 申 し 訳 あり ません が、 添付 CD-ROM の ご 利用を あきらめ てい 
ただく ことと なります9)。 

%  CD-ROM ドライブの 接統 

まず、 デバイス ドライバを インストール する 前に、 CD-ROM ドライブ 
が X680x0 と 接続され て いる こと を 確かめて ください (X68000  SUPER  VI 
降の 機種では SCSI 端子 同 ± を SCSI ケーブルで 接続し ます)。 

X68000  SUPE 民り JI の SCSI 端子がない 機種を お使いの 方は、 SCSI 力一 
ドを 購入す るか、 フリー ソフトの SxSliD) を 組み込んだ うえで、 添付 FD 
じ 収録した 前述の SUSIE を CONFIG.SYS に 組み込んで ください W。 

CD-ROM ドライブと X680x0 本体と のす 妾 続を 確認 したら、 CD-ROM ド 
ライブの 電源を入れ、 次に 本体の 電源を入れて X680x0 を 起動して くだ 
さい。 このと き、 すでに 添付の CD-ROM を セットして おいても かまい 
ません。 

0 デバイス ドライバの 登録 


10)SASI 端子し かない 機種 
で SCSI ハード ディスク 
や CD-ROM を 接続で き 
るよう じする ドライ ハ’。 


次に、 X680x0 の 起動が じ CD-ROM ドライブが 認識され、 アクセス 可 
能と なる よう、 前述の CD-ROM デバイス ドラ イノく を CONFIG.SYS じ 登 
奎录 します。 


11) 組み込み 方 まの 詳細に 
ついては、 をソフ トウ ェ 
アじ 付属の ドキ ュメン 
卜を 参照して くださし、。 


すでに、 なんらかの CD-ROM デバイス ドラ イノく を CONFIG.SYS に 登 
緑され ている 方は、 本 項での 作業は 不要です ので 次 項に 進んで ください。 
下では、 説明の 都合 上、 「2.1 添付 FD からの インストール」 （P.34) 
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12) 安全の ため、 添付 ディ 
スクを バックアップし 
た 作業用 ディスク のこ 
と。 


13) 対応 CD-ROM ドライブ 
じついても 記載され て 
います。 


で 作成 した インストール ディスク I2) を 挿入した ドライブを C ドライブと 
し、 デバイス ドライバを 登録す る CONFIG.SYS の ある 起動 ドライブを A 
ドライブと します。 また、 作業 ディ レクト リを 「A:¥™p」、 Human68k 
の デバイス ドライバ などの システム ファイルが 入って いる デイ レクト リ 
を 「A:¥SYS」 として 話を 進めます。 

イ ンス トール ディ スクを X680x0 本体の フ ‘ロッ ピー ディ スク ドライブ 
の 〇番に 挿入し、 インス トール ディスクを 挿入した ドライブ （ここでは C 
ドライブ） に々 レント ドライブを 変更して く ださい。 そ して、 インス トー 
ル ディ  スクじ 含まれて いる ファイル "CDR0M21.LZH" を 作業 ディ レクト 
リ にコ ピー します。 


A:¥>  C: 

C:¥>  COPY  CDR0M21.LZH  A:¥TMP 


次に、 々レン ト ディレクトリ を 作業 ディレクトリ に 変更し ます。 


C:¥>  A: 

A:¥>  CD  TMP 


そして、 添 か FD の ¥ETC ディレクトリ に 収め られ ている 111 a_x647  •  X 
を カレント ディレクトリに コピーし、 実 斤し ます （lha_x647.x は、 アー 
々イブ ユー ティ リ ティ LHa の 自己 解凍 型 ファイルです)。 すると、 ア ーカ 
イブ ファイルが 順に 展開され ていきます。 その 中の Iha.x を 使って、 先 
ほど コ ピー した ファイル "CDR0M21.LZH" の 中身を 展開し ます。 


A:¥TMP>  LHA  E  CDR0M21.LZH 

Extracting  from  Archive  :  keisoku/CDRGM21 . LZH 

cddev. sys  : 解; ま 終了  [  11874  ] (  11874  ) 

readme  .doc  : 解凍 終了  [  2068  ]  (  2068  ) 

V _ J 

計測 技研 提供の cddev . sys を 使う 場合には、 展開され た ファイルの 1 
つ readine.doc に CD-ROM デバイス ドライバの 使用 条件 口) が 記載され 
ています ので、 必ず 目を通して ください。 

上記の よう に 圧縮 ファ イ ルの 展開が 終わ っ たら、 CD-ROM デバイス ド 
ラ イノ  く 本体 cddev.  sys を システム ファイル •ディ レクト リ A:  ¥SYS にコ 
ピ ー します。 

^  A:¥TMP>  COPY  cddev. sys  ¥SYS  | 
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0 

0 

0 

1 

0 


ハード ディスク （SCSI) ユニット 番号 
光磁気 ディスク （SCSI) ユニッ ト 番号 


2  H  D  (  I  M  B) 

2  H  D  (  I  M  B) 

C  D  R  0  M  (SCSI) 
化 想 ドライ ブ です 


ユニッ ト 番号 —— 
ユニッ ト 番号.... 
ュニッ ト 番号 —— 


A:¥TMP> 


Z: イ反想 ドライブです 


A:¥TMP>  DRIVE 


14)  本 プロ グラムは SX- 
WINDOW 上で 動作す る 
ため、 あらかじめ SX- 
WINDOW が 利用で きる 
環境を 用意して わく 必 
要が あり ます。 

15)  計測 技研 提供の cdd 
ev.sys は、 メ ディア 
力、’ 挿入され ていない M0 
ドライブを CD-ROM ド 
ライブと 誤って 認識し 
てし まう 場合 も ありま 
すので、 •ま 意が 必要で 
す。 


©コラム： cddev . sys の 起動 オ プ シヨ 


cddev.sys を 利用す る 場合、 基本り 勺  DEVICE=A : ¥SYS¥cddev . sys  /ID 日 

にオプ ショ ンを 指定す る 必要は あり ませ 
ん。 オプションを 指定 しないが 態で CD- 
ROM ドライブが 認識され ない 場合は、 

下記の ように "ID" オプション じよって、 

CD-ROM ドライ ブの SCSI  ID 番号を 指 
定 してみ てく ださい。 


(CD-ROM の の が 5 の 場合） 

オプションの 詳細は、 アーカイブ ファ 
イル ‘‘CDR0M21.LZH，， に 含まれて いる 
ドキュメント "README . DOC" を 参照し 
てくだ さい。 


コ ピーが 終了 したら、 CONFIG.SYS に 次の 1 行を エディ タ などで 追加 
して、 X680x0 の 起動時に イ ンス トールした CD-ROM デバイス ドライバ 
が 登録され る ようにし てく ださい。 


List  2-1 •  CD-ROM ドライバの 化み 込み 


] 


1: DEVICE  =  A:¥SYS¥cddev.sys 


上記の よう に 書き加えた あと、 ファイル C 日 NFIG  •  SYS を セーブし てく 
ださい。 エディタを 終了し、 TYP 巨 コマンド などで CONFIG.SYS が 正しく 
書き換えられ ている ことを 確認したら、 リセット ボタンを 押して X680x0 
を 再起動し てく ださい。 

X680x0 の 再起動が 完了 したら、 CD-ROM ドライ ブが 正しく 認識され 
ている かどう か、 次の ように DRIVE コマンドを 使っ て 確認 します。 


上記の ように、 CD-ROM ドライ ブが 正しく 認識 されれば、 本 項の 目 
的で ある CD-ROM デバイス ドライバの イ ンス トールは 終了です。 次は、 
添付 CD-ROM に 収録され ている ソフ トウ エアの イ ンス トール プロ グラ 
ム I4) を 利用す るた めの 設定を 行います IS)。 


A  B  C  D  E  F 
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©コラム： 計測 技研の CD-ROM ドラ イノ く、 対応 CD-ROM ドライブ 


添付 FD に 収録され ている CD-ROM 
デバイス ドライバ cddev.sys が 列* 応 
している CD-ROM ドライブは 次のと お 
リ です。 

〇  SCSI にが 応 している CD-ROM ド 
ライブ （ただし、 NEC  PC-CD10,  PC- 
CD30,  Apple  CD150 を 除く） 

cddev.sys の 開発 元で ある 計測 技研 
で 動作を 確認して いる CD- ROM ドライ 
ブ はじ I 下のと おり です （199 日 年 4 巧 現在)。 

〇  TOSHIBA  XM3301， XM3401, XM 
4101， XM5901 


〇  SONY  CDU-561,  CDU-55S  (Ver. 
l.Of,  Ver.l.Oq  で 確言 忍、） 

〇  PLEXTOR 製の ドライブ 
〇 松 下 寿 製の ドライブ 
〇  NAKAM に HI  MB 民- 7 
〇ロジ テック LCD-440 
〇  DATA  WEST  DWR-22MS 

ここに 記載され ている CD— 民 OM ドラ 
イブは、 あくまでも 計測 技研で 動作を 確認 
した ドライ ブ です。 こ れ U 外の CD-ROM 
ドライ ブ でも 動作す る 可能性は あります 
が、 保証の かぎり では あり ません。 また、 
CD-ROM ドライ ブが 認識 さ れ ないから 
といって、 提供 元の 計測 技研に 質問な ど 
をし ないよう じして ください。 


添付 CD- ROM の 内容） 


添付 CD-ROM の ディ レクト リ 構成は Table  2-2 のよう になって います。 


化 ble  2-2  • 添付 CD-ROM の ディ レクト リ巧成 


デイ レクトり 名 

み 類 項目 

APL 

アプリケーション 

ARC 

アー 々イ バア プリ ケー ション 

DATA 

リ ソース データ 

DESKTOP 

デスク ト ップ アプリ ケー シ ョン 

DEVELOP 

關発 アプリヶーション 

DOC 

ドキ ュメン ト データ 

EDITOR 

エディ タアフ ° リ ケーシ ョン 

EXT 

SX— WINDOW を 拡張す る アプリ ケーシ ョン 

FILE 

フ ァイ ル アプリ ケー シ ヨン 

GAME 

ゲーム 

GRAPH 

グラフィック アプリ ケー シ ョン 

LANG 

言語 アプリ ケーシ ョン 

LIB 

開 猪 用 ライブラリ 

MUSIC 

FM 音源、 ADPCM 音源 アプ リケー ション 

SXllO 

SX-WINDOW  ver 丄 10 専用 アプリ ケーシ ョン 

TERM 

通信 アプリ ヶーシ ョン 

TOOL 

ツール アプリ ケー シ ョン 

それぞれの アプリ ケー シヨ ン プログラムは、 Table  2-2 のよう な アプリ 
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ケー ショ ンの ジャンル ごとに 分類して 収められて います。 各 ジャンル 名 
の ディ レクト リの 下には アプリ ケー ショ ン ごとに 分けられた ディ レクト 
りが あり、 その 下に 展開され た アプリケーションプログラムと、 ア ー々 
イブ ファイルを 収めた ¥ARC という ディ レクト リが あり ます。 

下に、 例と して 通信 ソフト QuTERM の デイ レクト リ 構成を 示します。 


¥TERM 

I - QUTERM 


: 通信 アプリ ケー シヨ ンの デイ レクト リ 
: QuTERM の デイ レクト リ 


-ARC  : 

- QUTERM54.LZH  : 

- QUTRM54S.LZH  : 

■QUTERM .  X 
-QUTERM.  HLP 
■QUTERM.  LB 


アーカ イブの ディレクトリ 
アー 々イブ ファイル 

ソース プロ グラムの アー カイ ブフ アイ ル 
アーカイブから 展開され た ファイル 


16) 当然ながら、 大文字 小 
文字の 区別 も あり ませ 
ん。 


17) インス トー ラを 使う こ 
とじ よって、 ハー ド デ 
ィ スク ヘア プリ ケーシ 
ヨン ソフトを インスト 
—ル する 際に オリ ジナ 
ルの ファイル 名に 自動 
的に 戾 します。 


前述の とおり、 添イ寸 CD- ROM は ISO9660 レベル 1 規格に 従っ た フォー 
マ、' ノ トで 作成され ている ため、 CD-ROM に 収録した アプリケーションの 
うち、 ISO9660 レベル 1 規格では 使えない 文字列 からなる ファイル 名 （漢字 
や々 タ カナな ど） の ものは 変更 させて いただきました iG)。 添付 CD-ROM 
には、 主な アプリ ケー ショ ンの実 斤に 必要な ファイルと ド キュメ ント ファ 
イ ルを 展開し たが 態で 収録 しまし たが、 上記の 理由 じより 添付 CD-ROM 
に 収録 されて いる 実行 ファイルを 直接 実 斤す る ことは できません。 

CD-ROM 内の アプリ ケー ショ ンソフ トをイ ンス トールす るには、 SX- 
WINDOW 上で 動作す るイ ンス トール プログラム （インス トーラ .X) を 使 
う 方法 I7) か、 ¥ARC ディレクトリ に 含まれて いる アーカイブ ファイル か 
ら ユーザ 自身が 手 作業で 展開す る 方法の 2 通り があります。 

本節では、 一部 ソフト ウて アのイ ンス トールに 必要な "TwentyOne.X" 
について 簡単に 説明 した あと、 インス トー ラを 使って ハー ド ディ スクに 
インス トールす る 方法と、 手 作業で ハー ド デイ スクじ インス トールす る 
方法を 順を 追って 解説し ます。 


Twenty 日 ne  •  X の 常駐 


18) たとえば  SXWINDOW.X 
と  SXWINDOWS.X  は 同 
じ ファイルと 見なされ 
てし まいます。 


Human68k では、 最大で 21 文字の ファイル 名 が 使え るよう な 機構が あ 
る ものの、 実際には そのうち 8 文字 （+ 拡張 子 3 文字） しか 認識され ない 
という 制限が あります IS)。 TwentyOne.X は、 この 制限を 取り 私う こと 
じよって 21 义字 すべてを 認識す る こ とがで き るよう にし、 さ ら に大义 
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19) たとえば、 String .  h 
と string .h が 同じ デ 
ィ レクト リ じ 含まれて 
いるな ど。 Twenty 
One.X を常延 させて い 
ない Human68k では ど 
ちら も 同じ ファ イ ル 名 
と して 誘、 識 されます。 


字- 小文字を 区別したり、 ファイル 名の 中に 複数の ピリオドが 使 ふるよ 
うに Human68k を 拡張する 常駐 ソフ トウ ェアです。 X680x0 用の アプリ 
ケー シ ヨン ソフト ウェアには、 この TwentyOne.X が 常駐して いる こと 
を 前提と した、 8 文字に I 上の 長い ファイル 名の もの や、 複数の ピリオド 
を 使った も のが 多数 存在 しています。 

添付 CD-ROM じ 含まれて いる アプリ ケー シ ョンのう ち、 「エディ タア 
プリ ケー シ ョン」 と 「開発 アプリケーション」、 「開発 用 ライブラリ」 に 
は、 上記の よう な 特殊な ファイル 名を 用いた ものが 含まれて います I9)。 
これらを イ ンス トー ルす る 場合には、 前述の TwentyOne.X の 機能が 必 
要と なり ますので、 イ ンス トー ラを 実 斤す る 前に TwentyOne.X を 常駐 
させて おく 必要が あります。 

TwentyOne.X の インスト ー ル 方法に ついては 「インストーラ の 起動」 
(P.47) を 参照して く ださい。 

TwentyOne  .X が 常駐して いない 状態で インス トー ラを 実 斤す ると、 Fig. 
2-1 のよう な 嘗告メ ッ セージが 表示され ます。 

F お.  2-1 •  TwentyOne.X が 常駐して いない 場合に 出る 警告 メッセー ジ 


このよう な 警告 メ ッ セージが 表示され た 場合は、 醒罰 ボタンを ク リッ 
ク すれば 警告メッセージが 消えて、 インストーラが 起動し ます。 この 状 
態で インス トール 作業を 続行す る ことは 可能です が、 一部の アプリ ケー 
ション を 正しく インスト ー ルす る こと がで きません。 一度 SX-WINDOW 
を 終了して TwentyOne.X を 常駐 させた う えで、 再度 SX-WINDOW を 
起動して く ださい。 

それでは、 いよいよ アプリ ケー シヨ ンの インス トールに ついて 説 巧し 
ます。 


インス ラを 用いた インスト ~ ル 


ん とる 

せを 

まま さ 
いしき 
で ル 害 
し 一 上。 
^K^がす 
巧 スル ま 
が ンィり 

e ィァ金 
化 まフが 
むま のれ 
がの¥ 

^^こ I お 
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まず 最初に、 添付 CD-ROM に 含まれて いる イ ンス トー ラの 役割に つ 


2-2 添付 CD-ROM からの インス h— ル 


いて 説明し ます。 

本書で 用意した インス 
トー ラ .X を 用いた もので 

〇  CD— ROM から ハー 

〇  ISO9660 レベル 1 礎; 
ファイル 名に 戻す。 


が 挙げられます。 本書の イ 
に 戻して コピーす る だけの 
ンを インストール （使える 


すので を 意して く ださい。 

また、 アプリ ケー シヨ 
が 必要な もの も ありま す;^ 《 
ません。 それぞれの アプ I) 

で 設定 作業を 巧って くだ^^ 
ラリ に 分類され ている ア T リ 
せん。 ソース プログラム 
目を 参照して ください。 


トー ラは、 SX-WINDOW 上で 動作す る インス 
主な 化理と しては、 

デイ スク などへ ファイルの コ ピーを 斤う。 
格に 従うよう に 変更され た ファイル 名を 元の 


ン ストー ラは、 フ アイ ル 名を 元の フ アイ ル 名 
プログラム であり、 いわゆる アプリ ケー シヨ 
よう に） する 一般的な インス トー ラとは 違い ま 


本に よっては、 実際に 利用 （実 斤） する 前に 設を 
本書の イ ンス トー ラは そこまで 対応して い 
ケー シ ヨンの ドキュメントを 参照して、 各自 
い。 ソース プログラム などは、 開発 用 ライブ 
ケー シヨ ンを 除いて イ ン スト ー ルを 斤い ま 
ホ 必要な 場合は 後述す る 手動 インス トールの 項 


20) インス トー ラ. X、 イン 
ス トー ラ. LB は 全角 力 
タ カナの ファイル 名で 
すので、 に 09660 のフ 
ァイ ル 名と して 使える 
ようじ 変更 させて いた 
どき ま した。 


それでは、 インス トー ノ^ 作業を 順次 見て いきましょう. 

添付 CD-ROM の ルー ト ディレクトリ には、 シャープ （株） の 許可を 得 
卜ーラ .LB を、 ISO9660 レベル 1 規格の ファイル 
名 規則に あわせて それぞれ. SETUP. X と SETUP. LB に 変更して 収録して あ 
ります 20)。 CD- 民 OM 巧の ファイルの コピー じは SETUP  .X と SETUP  .LB 
を お使いく ださい。 

まず、 SX- WINDOW を fe 動して CD-ROM ドライブの アイコンを ダブ 
ル クリックし 、ディレクトリ を 表示し ます。 

CD-ROM ドライブ アイ。 ンが デスク トップに 表示され ていない 場合は、 
ドライブ トレイ .X を 実 斤して、 ドライブ トレイの ウィン ドウの 内部 じある 
CD-ROM の ドライブ アイ： コンを デス クトッ プにド ラッグ & ドロップし 
た あと、 CD-ROM ドライブの アイ コンを ダブル クリ ック してく ださい。 

CD-ROM の ルー ト ディ レクト リ にある SETUP.  X を ダ ブルク リックす 
ると、 インス トー ラが 起動し、 Fig.  2-2 のよう な ウィン ドウが 表示され 
ます。 
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Fig.  2-2  • 起 巧 直後の インス トーラ 画面 


イ ンス トー ラの ウイン ドウ 画面には、 次の よう な 項目が 表示され てい 
ます。 


〇 インス トール 方法の 選択 

インストーラ ウィン ドウの 上方 じある 「インス トール 方法の 選が」 
の 右側には、 横に 長い ボタンが あります。 この ボタン じは、 現を 選 
が; 中の アプリ ケー ショ ンソフ トの夕 類が 表示され ています。 この ボ 
タ ンの 上で マウスの 左 ボタンを 押し 続ける と、 イ ンス トールす るア 
プリ ケー シ ョンの 夕類巧 回が Fig.  2-3 のように 表示され ます。 この 
とき、 左 ドラッグして、 インストールしたい アプリケーション 分類 
のう えで マウスの 左 ボタンを 離せば、 イ ンス トールす る アプリ ケー 
シ ョンの 分類を 変更す る ことができます。 

Fig.  2-3  •インス トールす る アプリケーション のみ 類 項目 


0 インス トール 概略 表示 部 

イ ンス トー ラ ウインドウ の左侧 には イ ン スト ー ルす る アプ リ ケー シヨ 
ンの アーカイブ 名 力ぶ 表示され ます。 チェック ボックスを クリ ック する 


2-2 添付 CD-ROM からの インス トール 


と、 チェック マークが ついたり 消えたり します。 チェック マークの つ 
いている て 頁 目の みが イ ン スト ー ルされ ますので、 すでに イ ン ストー 
ルされ ていて あらためて イ ンス トールす る 必要の ない アプリ ケー シヨ 
ンを インス トールし ないよう に 設定す る こ とがで き ます。 

イ ンス トールす る 内容の 概略 部分を クリ ック すると、 をの イ ン ストー 
ル 詳細 表示 部に インス トール 内容の 詳細が、 左下の ヘルプ 表示 部に 
は 概略が 表示され ます。 インス トールす る 内容が そこに 表示し きれ 
ない 場合には、 スクロール バーが 表示され ますので、 操作して スク 
ロールさせる ことができます。 

〇 インス トール 詳細 表示 部 

インストーラ ウィン ドウの 右側には、 イ ンス トール 概略 表示 部で 選 
択 された 巧 目の 詳細な 設定 内容が 表示され ます。 設定 內容 は、 イン 
ス トール 概略 表示 部で 選が された 項目 じよって 異なり ます。 

〇 ヘルプ 表示 部 

インストーラ ウィン ドウの 左下には、 イ ンス トール 概略 表示 部で 選 
択 された 項目に 関する 説明が 表示され ます。 

〇 実行 ボタン 

匡 置! ボタンを ク リックす ると、 チ ユック ボックスで チェック された 内 
容じ 従って インス トールが 開始され ます。 インス トール 中は Fig.  2-4 
のよう なイ ンス トール ダ イア ログ が 表示 されます。 

Fig.  2-4  • インスト ー ル ダイ ア ログ 


メ ッ セージ 表示 部には、 現在 どの アプリ ケー ショ ンをイ ンス トール 
している のかな どを 示す メ ッ セージが 表示され ます。 メ ッ セージの 
横の 数字は、 インストールされ ている ファイル 数を 示して います。 イ 
ンス トール 中に 圧] B ボタンを 押す と、 イ ンス トールは 中止され ます。 
さらに、 ここで i 中正] ボタンを 狎 すと、 これまでに インストールされ 
たアプ リケー ション 名の 前につ いた チェック マーク が 消 えてい ます。 
インス トールを 再開 するとき は、 匿理 ボタンを 押す と、 インスト ー 
ルの 終わって いない アプリ ケー シ ヨンの インスト ー ルを 始めます。 
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0 取消 ボタン 

關ボタ ンを クリック すると、 インストーラ が' 終了 します。 

イ ンス トー ラの ウィン ドウ 画面は じ I 上の ようじ なって います。 

® インス トー ラの インストール 

それでは イ ン ストー ラの インス トールを 始め ま しよう。 「インス トール 
方法の 選択」 の 右側に ある 横に 長い ボタン 部分を 左クリ ック すると、 分 
類て 頁 目が Fig.  2-5 のように 表示され ますので 「インストーラ •インスト ー 
ル」 を遵択 してく ださい。 

まず 最初に、 SETUP  .X と SETUP.  LB を ハー ド ディスクに インス トール 
します。 


Fig.  2-5  • み 巧 項目の 画面 


この 操作で、 いく つか 存在す るイ ンス トー ラの なかで 「イ ン ストー ラ- 


Fig.  2-6  •インストーラ. インスト ー ルの 起 助 画面 
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2-2 添付 CD-ROM からの イ ンス トール 


21) デフ オルト では A:¥ 
X68 が 表示され てい ま 
す。 


インストール」 という 名前の インストーラが 起動し ます。 すでに インス 
トー ラ •インス トール カぶ 起動して いる 場合は 何も しなくて かまいません。 

インスト ー ル 詳細 表示 部と、 ヘルプ 表示 部が Fig.  2-6 のよう に 表示 さ 
れ ます。 

イ ンス トール 詳細 表示 部の 「イ ンス トール 先 ディレクトリ」 の 下 じある 
文字列 部分2 1) を 左クリ ック すると、 イ ンス トール 先 ディレクトリ を ネー 
ボー ドから 入力で きる よう になり ますので、 SETUP .X と SETUP. LB をイ 
ンス トールす る ディ レクト リ 名を 入力して く ださい。 

設定 後の 画面を Fig.  2-7 に 示します。 

Fig.  2-7  ♦インストー ラ. インスト ール 設定 後の 画面 


なお、 インストールが 終了す ると、 SETUP  .X と SETUP.  LB は、 元の イン 
ストール .X と インストール .LB に 名前が 変更され ています。 添付 CD-ROM 
に 収録され ている SETUP .X と 沈 TUP.LB は、 現在 入手で きる 最新 バー 
ジョン （タイムスタンプは 95-02-22  12:00:00) の インス トーラ .X、 インス トー 
ラ  •  LB  の 名前を  変更した  ものです  ので、  すでに  SX- WINDOW  ver.3.1 シ 
ステ ムネッ ト や、 開発 キッ ト ツール 集な どで インス トーラ .X を 入手され 
ている 方 も、 再度 SETUP.X と SETUP.  LB をイ ンス トールす るよう じし 
てく ださい。 

すでに 古い バージ ョンの インストーラ .X がイ ン スト ー ルされ ている 場 
合は、 その ファイルが ある ディレクトリ 名を 指定して、 インストーラ .x 
が 本書 添付の 新しい もので 上書き される ようにして ください。 古い バー 
ジョ ンの インス トーラ .X が 残って いると、 の I 後の イ ンス トール 作業が 正 
しく 行われる 保証はありません ので、 ご注意く ださい。 

インス トール 先 デイ レクト リの 設定が 終了 したら、 匡理 ボタンを 押し 
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Chapter  2 インストー ル 


てく ださい。 添 か CD-ROM 上に ある 最新 バージ ョ ンの SETUP.X が イン 
ストーラ .X と して ハー ド ディスク じ インス トールされ ます。 

「インストーラ •インス トール」 の 内部では アイコ ンの 定義と 設定を 
斤って いますので、 この 設定を 有効に する ためじ 一度 SX-WINDOW を 
再起動し なければ なり ません。 

インストールが 終了す ると、 「登録した アイコンを 保存す るた め、 SX- 
WINDOW を 再起動し ます」 という ダイアログが 表示され ます （Fig.  2-8)0 


Fig.  2-8  • 再起動の ダイアログ 

Hi" 


5> 


登 S ました アイコ ンを 保な する ため、 
SX-WIND0I1! を 再起 I わします。 


BI 


22)  ".INS" ファイルは イ 
ンス トー ルす る アプリ 
ケー シヨ ン のみ 類 じよ 
つて、 TERM.  INS  (通信 
アプリ ケーシ ヨン） や 
GAME.  INS  (ゲ ームプ 
ログ ラム） などと なって 
います。 


この ダイアログで 屋 置! ボタ ンをネ 甲して く ださい （SX- WINDOW 力ぶ 再起 
動され ます)。 再起動 後に CD-ROM ドライブの ディ レクト リ を 表示 させ 
ると、 お 張子が". INS" のフ ァイ ルが 専用の アイコン で 表示 されます22)。 

じ [上の 操作で インス トーラ .X が ハー ド ディ ス クじイ ンス トールされ ま 
した。 

0 アプリケーションの インストール 

次は、 添 か CD-ROM に 収録 されて いる アプリ ケーシ ョンの インスト ー 
ル 方法 じついて 説明し ます。 

SX-WINDOW 上から CD-ROM ドライ ブの ルー ト ディレクトリ にある 
SETUP.X を ダ ブルク リックして インス トー ラを 起動して く ださい。 

「インス トール 方法の 選択」 の 右 じある ボタンを 左ク リックす ると、 
Fig.  2-5 のよう に 分類 項目が 表示され ますので、 イ ンス トールしたい アプ 
リ ケー シ ョンの 分類を 選択して ください。 ここでは、 例と して 「通信 ア 
プリ ケー シ ヨン」 を 選択し ます （Fig.  2-9)0 


64 


2-2 添付 CD-ROM からの インストール 


Fig.  2-9  • 通信 アプリ ケーシ ヨンの インス トーラ 画面の 選択 


「通信 アプリ ケー シヨ ン」 インス トー ラの 起動 直後の 画面を Fig.  2-10 
に 示します。 


Fig.  2-10  • 通信 アプリ ケーシ ヨンの インス トー ラ 起動 画面 


インス トール 概略 表示 部 （イ ン ストー ラウ ィン ドウの 左側） には、 アプ 
リ ケー シヨ ンの アーカイブ 名が 表示され ています。 インス トール 概略 表 
示 部の 左側 にある チ ユック ボックス じ チ ユック がつ いている と、 その アプ 
リケ ーシヨ ンがイ ン スト ー ルされ る ことを 示して います。 

イ ンス トール 概略 表示 部の アプリ ケー シヨ ンの アーカイブ 名が 表示 さ 
れ ている 部々 をクリ ック すると、 ヘルプ 表示 部に 該当する アプリ ケー シヨ 
ンの 簡単な 説明が 表示され ます （Fig.  2-11)。 


65 


Fig.  2-11 ♦ アプリケーションの 概略 説明 


すでに 該当する プログラムが イ ンス トールされ ており、 新たに アプリ 
ケー シ ョンを インス トールしたくない 場合には、 イ ンス トール 概略 表示 
部の チェック ボッ クスを 左ク リックして オフに します。 その アプリ ケー 
ショ ンを はじめて インス トールす る 場合は、 そのまま 展 行] ボタンを 左ク 
リ ック すれば、 アプリケーションの 利用に 必要な プログラムが イ ン ストー 
ルされ ます。 

インス トール 概略 表示 部 じある プログラムを イ ンス トールす るかし な 
いかを チ ユック ボックスで 指定し 終わったら、 インス トールを 実 斤す る 
前に、 インストール 概略 表示 部の 先頭に ある 「インストーラ 設定」 の义 
字 部分を 左 クリック して インス トー ラの 設定を 巧い ます。 

インス トール 詳細 表示 部に 表示され ている イ ンス トー ラの 設定には、 
次の よう な 項目が あります （Fig.  2-7)。 

〇 「アプリ ケー ショ ン 名の ディレクトリ を 作る」 チェック ボックス 
この チ ユック ボックスは、 後述す るて 貫目 「SX- WINDOW 実 斤 ファ 
イ ルディ レクト リ」 で 指定され た ディ レクト リ名 （デフォルトでは 
A:¥X68) に、 アプリ ケー ショ ン 名から なる サブ ディ レクト リ （たと 
え ば、 ¥qUTERM) を 作成した あと、 その ディ レクト リ （たとえば、 
A:¥X68¥QUTERM) に 実行 ファイル などを イ ンス トー ルす る 指定です。 
ただし、 アプリケーション ごとに ディ レクト リ を 作成して いくと、 ア 
プリ ケー ショ ンを 利用す る 段階で SX-WINDOW が 実 斤 ファイルを 
検索す る 際に 時間が かかる ことな どから、 デフォルトでは、 この 設 
定を OFF にして います。 できるかぎり ディレクトリを 分割せ ず、 ア 
プリ ケー シ ョンを 同じ デイ レクト リに インスト ー ルす るよ うにして 
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く ださい （詳細は 次 ページの コラムを 参照)。 

0 「 日付の 新しい ファイル のみ コピ ー」 チェック ボックス 

この チェック ボックスは、 イ ンス トール 先 ディ レクト リ にイ ン ストー 
ノレし ようと している ファイルと 同じ ものが あった 場合に、 既存の ファ 
イ ルと CD-ROM 内部の ファ イ ルの 日 かとを 比較して、 CD-ROM 内 
部の ファイルの 日付が 新しい 場合に のみ コピーす る 指定を 行う オプ 
シ ョンです。 デフォルトでは ON になって います。 

〇 「各 アプリケーションの チェック ボックスを すべて クリア」 ボタン 
この ボタンを 押す と、 イ ンス トール 概略 表示 部に 表示され ている 各 
アプリ ケー ショ ンの チェック ボックスが すべて OFF じなり、 各アプ 
リ ケー ショ ンの インス トール 動作を 斤わない 設定に なり ます。 

イ ンス トール 概略 表示 部 じたく さんの アプリ ケー ショ ン 項目が ある 
よう な 場合、 デフォルトで ON になって いるすべ ての アプリ ケー ショ 
ンの チェック ボックスを ひとつひとつ OFF にす るの が 大変な 場合に 
利用し ます。 

OSX アプリ ケー シヨ ン ディレクトリ 

SX-WINDOW アプリ ケー ショ ンをイ ンス トー ルす る ディ レクト リを 
ホ旨定 します。 

この 他の 分類の アプリ ケーシ ョン （開発 用 アプリ ケーシ ョンな ど） では、 
さらに 次の ような て 頁 目が 表示され る ことがあります ので、 適宜、 指定し 
てくだ さい。 


〇  Human アプリ ケー シヨ ン ディ レクト リ 

Human68k 上で 動作す る アプリ ケー シヨ ンの 実行 ファイルを イ ンス 
トールす る デイ レクト リ をす 育定 します。 


〇 コンパイラ/ ライブ ラ リ ディレクトリ 

コンパイラ や、 専用 アセンブラ、 各種 ライブラリを インストールす 
る ディレクトリ をす 旨定 します。 


〇  mu 丄 e  /  demacs テ、、 イ レクト リ 」 

mule や demacs を インスト ー ルす る ディレクトリ を 指定 します。 

インス トール 方法の 選択に 表示され ている アプリ ケー シ ヨンの 分類が 「エ 
ディタ アプリケーション」、 「開発 用 アプリケーション」 または 「開発 用 
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©コラ 厶： 実行 ファイルの 検索 


SX-WINDOW では、 広大な ハー ド デ 
ィス ク 内部 に 散在す る 実行 ファ イ ルを 検索 
する 際に、 過 まに 実 斤した 実 斤 ファイルの 
あった ディ レクト リ 名を SYSDT 日 P.SX 
という リ ソース ファイル のなかに 記憶し 
て おき、 その 記憶を もとに ファイルの 検 
索を 斤い ます。 これは、 Human68k の 環 
境 変数 PATH じ 近い 機能と もい えます 
が、 SX-WINDOW では 実行 フ ァイ ルを 
実行す るた びじ 自動的に 内容を 新しく 更 
新して いる 点で 異なります。 記憶され て 
いる ディ レクト リ 名の 場所に 実行 フ ァイ 
ルが 存在し なかった 場合は、 ハード ディ 
スク 巧の すべての ディ レクト リ 領域を 検 
索す るよう になって います。 

しかし、 SYSDTOP.SX には 実行 ファ 
イ ルの ディ レクト リ を 記憶す る 領域は 255 
バイトし かありません ので、 あちこちの 


ディレクトリ に 実行 ファイルが 散在して 
いると、 実 斤す るた びに 新しい ディ レク 
トリを 記憶す る ことで、 過 まの ディ レク 
トリ 記憶が 消 ま されて しまいます。 この 
ため、 アプリケーションを 起動す る 際に 
「検索 中です」 の ダイアログが 表示され、 
ハー ド ディ スク 内部を 検索して いる 間、 
待たされる ことが 多くなります。 

このよう な 現象を 回避す るた めには、 
実 斤 ファイルを 特定の 1 つか 2 つかの 
ディレクトリ （たとえば、 "¥X68" など) 
に 集めて おく ことが 重要です。 

添 か CD— ROM のイ ンス トー ラに おい 
て、 デフォルトでは アプリ ケーシ ヨン ご 
との サブ ディレクトリ を 作成し ない 設定 
となって いる 理由は、 実 斤 ファイルを！々 
所に まとめて 置いて おく ためな のです。 


ライブラリ」 の 場合は、 ファイル 名の 大文字 小文字が 区別され る モード 
で インストール されます。 このため、 上記の 巧 目で 設定す る ディ レクト 
リ 名の 大文字 小文字の 違いに も 注意 しつつ 設定して く ださい。 

これらす ベての 設定が 終了 したら、 匿 固 ボタンを 押す と インス トール 
作業が 始 まります。 インストール 中は Fig.2-12 のよう な ダイア ロ グが表 
示されます。 


Fig.  2-12  •インス トール 中の ダイアログ 


ン ストール 中 


QUTERM54.  LZH の インストール 中. .. G 


ダイアログの 中に 表示され ている 数字は、 現在 コ ピーして いる フ ァイ 
ルの 数が 表示され ます。 ファ イ ル 数の 少ない アプ リ ケー シヨ ン では 2 つ、 
非常に 大きな アプリ ケー シヨ ン では 1000 を 超える こ とが あり ます。 
インス トール 中に 圧^ ボタンを 押す とイ ンス トールは 中止され ます。 こ 
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の 場合、 すでに イ ンス トールを 終了 した アプリ ケー シヨ ン について は、 
インス トー ラの 概略 表示 部の チェック マークが 消えて いますので、 イン 
ス トールを 再瞒 したい 場合は もう 一度 匿 置! ボタンを 押す ことによ り、 イ 
ン スト ー ルを 中断した アプリ ケー シ ヨンから インスト ー ルを 再開す る こ 
と がで きます。 

イ ンス トールが 終了す ると、 「ファイル アイ コンを 表示させる ため、 SX- 
WINDOW を 再起動し ます。」 という ダイアログ (Fig.2-13) が 表示され 
ます。 


Fig.  2-13  • ファイル アイコン 表示の ための 再を 動 ダイアログ 

確認 

^ ブ 7 イル アイコンを 表示す るた め、 
SX-IDINDd を 再起 郎 し 逢す。 

圃 SI 晒 


インス トー ラに よって ハー ド ディ ス クじコ ピーされ た ファイルは 再起 
動す る ことによって 初めて SX-WINDOW で 表示され るよう になり ます。 
これは、 SX システムが 標準では 長い ファイル 名 や マルチ ピリオドを 用い 
た ファイル 名を 取り扱う ことができな いため、 インス トー ラでは フ ァイ 
ルの コピ ー を Human68k の 機能を 利用 して 行って おり、 インスト ー ル 直 
後の が 態では イ ンス トールした ファイルの アイコ ンが 表示され ないた め 
です。 

インス トールした ファイルの アイ コンを 表示 させたい 場合は 医盈 ボタ 
ン を、 他の 分類の アプリ ケー シヨ ンを 続けて イ ンス トールしたい 場合は 
印 正！ ボタンを 押してく ださい。 

再起動 後に 表示され る ファイル アイコン カぶ、 他の アイ コンの 上に 重なっ 
て 表示され、 見えに くい 場合が あります。 また、 SX システムの 標準で 
は 長い ファイル 名を 持つ ファ イ ル や、 フ ァイ ルの 先頭に ピ リオ ドを 持つ 
ファイル、 複数の ピ リオ ドを 持つ ファイルは 取り扱えない 場合が ありま 
すので、 上記の ような ファイルを 取り扱いたい 場合には、 SX-WINDOW 
を 終了 して コマン ドラ インから 取り扱う ようにし てく ださい。 

前に も 述べた ように、 イ ンス トー ラが 取り扱う のは ファイル 名の 変更 
とコ ピー だけです ので、 アプリ ケー シヨン によって さ らに 設定が 必要な 
ものは、 アプリ ケー ショ ン にか 属する ドキュメント を 参照して 必要な 設 
定を 斤って ください。 
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u 上で インス トール （ハー ド デイ スクに 実行 ファイルを コピーす る） 作 
業は 終了です。 


手動 インス ル 


ここでは、 か 属のイ ンス トー ラを 用いずに 手 作業で アプリケーション 
を ハー ド ディ スク などに イ ン スト ー ルす る 方法に ついて 説明し ます。 

では、 添付 FD を 挿入した ドライブを C ドライブ とし、 CD-ROM 
ドライブを E ドライブ、 インス トールす る ハー ド ディ スク ドライブを A 
ドライ スイ ン ストール する ハー ド デイ スク 上の ディ レクト リを A:¥X68 
と して 話を 進めます。 

例 として、 「添が CD-ROM の 内容」 （P.56) で 例 として 示した 通信 ソフ 
卜 QuTERM の アーカイブ 服 張子が" .LZH" の アーカイブ） を 展開す る 場 
合を 示 します。 


A:¥>CD  X68 

A:¥X68>LHA  X  E : ¥TERM¥QUTERM¥ARC¥QUTERM54 . LZH 


アーカイブの お 張子が" .TGZ" の 場合は、 添イ寸 FD に 収録され ている 
TXF.R という プログラムを 用いて 展開し ます。 

TXF.R を 持って いない 方は、 添付 FD に 収録され ている TXF.R を ハー 
ド ディスクの 中の Human68k の 環境 変数 PATH で 指定され ている ディ レ 
ク トリに コピーして おきます。 ここでは、 A:¥BIN じ コピーす る 例を 示し 
ます。 

^  A:¥>C0PY  C:¥BIN¥TXF.R  A:¥BIN  j 

TXF.R を 利用 して、 拡張 子が ".TGZ" の ファイルを 展開す る 方法を 次 


に 示します。 


A:¥>CD  X68 

A:¥X68>TXF  -x  E : ¥ARC¥VIS0N¥ARC¥VIS0N1 1 1 . TGZ 


手動 イ ンス トールでは、 上述した よう に ひとつひとつ アーカイブを 展 
開 していかなければ なり ません。 

各 アプリ ケー シヨ ンの ソースファイルは、 ソフト ウェア 作者の 方々 の 
ご協力を 得て、 可能な かぎり 添が CD- ROM に アーカイブの 形式で 収録 
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させて いただき ま した。 ソースファイルの アーカイブが ある アプリ ケー 
シヨ ン について は、 実行 ファイルの アーカイブと 同様に ¥AIIC ディ レク 
トリ に ソースファイルを 収めて あり ます。 

ソース ファイルの ハー ド デイ スク への コ ピー 作業は イ ン ストー ラでは 
扱いません ので、 ソースファイルを 必要と される 方は、 手 作業で コピー 
して 展開して いただく ことにな り ます。 

じ 1上、 ざっと インストール 作業に そって 流れを 追ってき ました。 イン 
ス トール 作業 そのものは、 設定が 複雑な だけで それほど 難しい ものでは 
あリ ません ので、 注意 深く 設定を 斤って いただければ、 誰に でも 簡単に 
インス トール 作業を 斤う ことができる ことで しよう。 

本書では、 添付 CD-ROM に 収められた 秀作 アプリ ケー シ ヨンを 読者 諸 
兄の ハー ド ディ スクじ コピーす ると ころまでを 手助けい たします が、 そ 
れら アプリ ケー シヨ ンを 使いこなせる かどう かは あなた 次第です。 添付 
CD-ROM に 収録した、 SXer こと SX-WINDOW 使いら の ソフトウェア 
で、、 あなたの SX-WINDOW ライフが 少しで も 華やか じなる ので あれば 
嬉しい かぎりです。 

最後に なり ま したが、 ソフ トウ ユアの 収録を 快諾して いただけ ま した、 
数多 くの ソフ トウ 卫ア 作者の 方々 に 感謝いた します。 
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本章では、 添が FD じ 収録され ている 
SX-WINDOW アプリケーションの 開 
発 環境のう ち、 SX31KIT と call 凸〇 
header じついて 説明 します。 

また、 SX— WINDOW  ver.3.1 で 追加 
された 機能の 一部 じついても サン プ 
ル プログラムを ま じえ て 解説を しま 
す。 


Chapter  3  SX-WINDOW  ver  3.1 開発 キット 


C 言語で SX-WINDOW の プログラムを 開発す るには、 次の ような も 
のが 必要です。 

〇 構造体の 定義 

SX-WINDOW の さまざまな レコードを C 言語から 利用す るた めじ、 

構造体と して 定義して おく 必要が あります。 

OSX コールの 宣言 

SX コールを C 言語から 呼び出す ためじ、 あらかじめ 関数と して 宣 

言して おく 必要が あり ます。 

OSX コールの ライブラリ 

実際に SX コールを 呼び出す ために 必要に なり ます。 

通常、 前 二者は インクルード ヘッダと して、 後者は ライブラリ フ ァイ 
ルと して 準備して おきます。 

シャープから 発売され ている Workroom じは、 C 言語で SX-WINDOW 
の プログラムを 關 発する ために 必要な イ ン クルー ド ヘッダと ライブラリ 
ファイルが 付属して います。 し 力 S し、 残念な ことに、 Workroom 付属の 
イ ン クルー ドへ ッ ダ や ライ ブラ リファイ ルは SX-WINDOW  ver.2.0 まで 
にし か 対応して いません。 

本書で 提供す る SX31KIT は、 SX-WINDOW  ver.3.1 までに 新たに 追 
加され た 機能を C 言語から 利用す るた めの 開発 環境です。 SX31iaT は 
Workroom を お 張す る 形で 構成され ています。 そのため、 


SX31KIT の 利用には Workroom が 必要 不可 义 


です。 

SXSIKIT は XC， gcc のど ちらで も 利用す る こ とがで き ます。 しかし、 
第 1 章で も 述べた ように、 本書では C コ ン パイ ラと して gcc を 推奨して 
います。 SX31KIT  は 「3.3  callno  header」 （p.lll) で 紹介す る  callno 
header とともに 利用す る ことで 大きな 力を 発揮し ます。 ただし、 callno 
header を 利用す るには、 コ ンパ イラは gcc でなければ なり ません。 
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3-1  SX31KIT  とは 


1)SX31KIT の インスト 
-ル 方法は 第 2 章 「ィ 
ン スト ー ル」 （P.33) を 
参照して くピ さい 


2) この ほ 力、 にも、 

SXCALL.H,  SXCALL 
.EQU,  SXCALL. MAC 
があります 力 <、 これら 
は アセンブラ 用の マク 
ロ ファイルです。 コラ 
厶 「アセンブラ マクロ 
ファイル」 （P.  157) で 説 
明して あります。 


本節では SX31KIT を 利用した 備 単な サンプル プログラムを 通して、 
SX31KIT の 基本的な 使い方を 説明し ます。 はじめて C 言語で SX-WIN 
DOW の アプリ ケー ショ ンを 作成し よう という 方は、 説明を よ く 読んで 
基本を 学んで ください。 また、 すでに SX-WINDOW での プロ グ ラミン 
グに 慣れて いる 方は、 本節を 読み 飛ばして も かま いません。 

なお、 卷 ホの APPENDIX  A 章には SX31KIT の 技術的 情報を まとめて 
おきました ので、 必要に応じて 参照して ください 1)。 


SX31KIT  ©構成) 


SX31KIT は、 インク ルー ド ヘッダと ライブラリ ファイルから 構成され 
ています。 

インク ル ー ド ヘッダ 

SX31KIT じか 属して いる インク ルー ド ヘッダを Table  3-1 に 示します2)。 


化 ble  3-1 •  SXSIKFT 付属の イ ン クルー ド ヘッダ 


ファイル 名 

内  容 

COLOR. H 

々ラーマン 関数の 定義 ファイル 

DIALOG. H 

グイ アロ グ マン 閱 数の 定義 フ ァイ ル 

MENU.H 

メニュー マン 間数の 定義 フ ァイ ル 

PRINT. H 

プリン トマ ン閒 数の 定義 ファイル 

SXDEF2 . H 

SX ライブ ラ リ闡数 用の 共通 シンボル 定義 ファイル 

SXGRAPH.H 

グラ フ マン 系の 閱 数の 定義 フ ァイ ル 

TASK.H 

タスク マン 関数の 定義 ファイル 

TEXT.H 

テキス トマ ン闕 数の 定義 ファイル 

VIDEO. H 

ビデオ マン 間数の 定義 フ ァイ ル 

WINDOW. H 

ウィン ドウ マン 系の 関数の 定義 フ ァイ ル 

これらの うち COLOR.  H と VIDEO.  H について は SX-WINDOW  ver.3.1 
の SX コー ルを 使うた めに 新たに 導入され たもので、 Workroom じは あ 
りません。 その他の インク ルー ド ヘッダは、 Workroom 付属の ものの 上 
位 互換と なって いて、 完全に 置き換える ことが 可能です。 

また、 ここ に 挙げ られ ていない CONSOLE.  H,  CONTROL.  H,  EVENT.  H,  RE 
SOURCE. H,  SXMEMORY.H について は、 Workroom の ものを そのまま 利用 
します。 

SXSIKIT では、 Workroom と 同様、 マネー ジャ ごとに インク ルードへ ッ 
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ダが 分割され ています。 アプリケーションの ソースコードからは、 使用 
する マネージャの イ ン クルー ド ヘッダ だけを 読み込みます。 

たとえば、 アプリ ケー ショ ンで メニュー マンの 闕 数を 使用 するとき は、 
ソ ー スコ ー ド カ >  ら、 

#inlcude  <MENU.H> 

として インク ルー ドへ ッ ダを 読み込みます。 

0 ライブラリ ファイル 

SX31KIT に付厲 する ライブ ラ リファイ ルを、 Table  3-2 に 示します。 


化 ble  3-2  •  SX31KIT 付 巧の ライ ブラ リファイ ル 


1 ファイル 名 

1  内容  1 

SXSLIB. A 

AR.X で 了 一カ イブした ライブ ラ リファイ ル 

3) インス トー ラの 質問 
への 答え じよって、 
libsx3.a,  libsx.l 
じなる 場合 も あり ます。 


SX3LIB.A には、 SX-WINDOW  ver.3.0/3.1 で 追加され た SX コールの 
み 力ぶ 含まれて います。 C 言語の スター ト アップ ルーチン や、 SX-WINDOW 
ver.2.0 じ I 前の SX コー ルに ついては Workroom 个禍の SXLIB.L を 使用 
しなければ なり ません。 

たとえば、 foo.c という ファイル 名の プログラムを コンパイル する 場 
合、 コンパイラが XC ならば、 

^  CC  too.c  — 皿 ainr.o  sx31ib.a  sxlib.l  | 

と します3)。 コ ン パイ ラが gcc ならば、 

I  gcc  too.c  — mainr.o  -lsx3  -Isx  | 

のように します。 

SX31KIT では、 ライブ ラ リファイ ルは XC  ver.l で 使用され ていた A 民 
形式に なって いますが、 XC  ver.2 を お持ちの 方は、 LIB.X を 用いて 次の 
よう じ 変換 作業を 行う と、 XC  ver.2 相当の LIB 形式に 変換す る ことが で 
きます。 

^  lib  sxSlib . 1  SX 311 b.a  j 

なお、 この 作業は 添 か FD の インストーラが 行います ので、 ユーザが 
瞒接 斤う 必要は あり ません。 
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SX31KIT を 使った サンプル プログラム 


4) コラム 「階層 メニュ ー」 
を 参照。 


では、 SX31KIT を 使う と、 どんな プログラムが 開発で きる ので しょ 
うか？ 

ここでは、 階層 メニュー4) を 扱った サンプル プログラムを 取り上げます。 
まず、 SX31KIT が 正しく インストールされ ている かどう かの 確認の 意 
味 も かねて、 サンプル プログラムを コンパイルして みましょう。 コンパ 
イル 作業は SX-WINDOW 上では なく、 コマンド ライ ン 上で 斤い ます。 

サンプル プログラムを コンパイル する ための 作業 ディレクトリ を 用意 
します。 ここでは A:¥work を 作業 ディ レクト リ とします。 

a:¥>  mkair  work 
A:¥>  cd  work 

V _ J 

次 じ 本書 添が ‘FD の ¥sainple¥sample デイ レクト リ から、 skeleton,  c, 
sample . c,  sample .h  という 3 つの ファイルを、 用意した 作業 ディ レクト 
リ じコ ピーし ます。 ここでは B ドライブに 添が FD が ある ものと します。 


©コラム： 階層 メニュ ー 


SX- WINDOW  ver.S.O じ なって、 階膽 
メニ ューが 正式に システムで サポ ートさ 
れ ました。 階睛メ ニュー とは、 メニ ューア 
イ テムと して 別の メニュー （子 メニュー） 
が あり、 その 別 メニューの アイテム とし 
て さらに 別の アイテムが ある、 というよ 
うじ メニュー が 階昭的 に 構成 されて いる 
ものの ことです。 この 説明で よく わから 
ない 場合は 添 村 •  FD 内の ¥SAMPLE サン 
プル ディ レクト リ の サンプル プログラム 
を 実 斤して みて く ださい。 

階が メニューの 使い-ぶを 俯 単に 説明し 
ます。 階層 メニ ューの レコードの 憐成も 
体は、 従 ホの メニューの レコー ドと まった 
く 同じです。 異なる のは、 ある メニュー ア 


イ テムに 子メ ニュー をつ ける 場な、 その 
メニュ ー アイ テムの シヨ ー ト 々ッ トキ ー 
コ ー ド {こ エス ヶ ー プ （Ox lb) を、 チェ、 ソ 
クマー クに子 メニュ ーのリ ソース ‘MENU’ 
の ID を おを する ことです。 つまり、 子 
メニ ューは あらかじめ リ ソース ファイル 
にな 録 されて いなければ ならず、 しかも、 
その リ ソースファイルが 才 ープン されて 
いなければ なりません。 メニューの 表示 
や邀 がを する 場合に も、 今までの ように、 
MNSelect を 使用し ます。 階 柄 メニュー 
の アイテム が遵 ばれた 場な、 返り 俯の 上 
位ワー ドに その 階 辟 メニュ ーのリ ソース 
‘MENU’ の ID が、 下位 ワー ドに アイテム 
を 号が 格納され ます。 
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A :  ¥work>  copy  b :  ¥sainple¥sample¥skeleton .  c  a: 

A : ¥work>  copy  b :  ¥sample¥sample¥sainple .  c  a: 

A : ¥work>  copy  b :  ¥sample¥sainple¥sainple  . h  a: 

V _ J 

同時に、 あなたが 使用す るコ ン パイ ラに あわせた バッチ ファイル もコ 
ピーし ます。 コンパイラに gcc を 使用 するならば MAKEGCC.BAT を、 XC 
を 使用 するならば MAKEXC.BAT を 選が します。 ここでは、 コンパイラと 
して gcc を 利用す る ものと します。 

I  A:¥work>  copy  b : ¥sample¥sainple¥MAKEGCC . BAT  a:  i 

3 つの フ アイ ルを コ ピーで きたら、 いよいよ コ ン パイルです。 

コマンド ラインから MAKEGCC.BAT を 実行し ます。 も しあな たが XC を 
使って いるなら、 MAKEXC.BAT を 実行して く ださい。 

^  A:¥work>  MAKEGCC.BAT  I 

SX31KIT および コ ン パイ ラが 正しく イ ンス トー ルされ ていれば、 作業 
用 ディレクトリに S  ample.  X という 実斤フ アイ ルが できて いるは ずです。 

最後に、 SX-WINDOW を 起動して できあがった 実 斤 ファイルが 正しく 
動作す るか どうかを 確認し ます。 なお、 sample  .x の 実 斤 じは sample  .lb 
が 必要です ので、 先 ほどと 同様 じして' 添付 FD から コピーして ください。 
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アプリ ケ ~ シ ヨンの 基本 構造と スケ ル トン > 


ここでは、 サンプル プログラムを 通して SX-WINDOW アプリ ケー シヨ 
ンの 基本 構造を 具体的に 説明し ます。 また、 SX31K  口の 利用の しかたに 
ついても、 必要に応じて ふれて いきます。 

まず、 SX-WINDOW アプリ ケ ーシヨ ンの 基本 構造を 衞 単に 復習し ま 
す。 「1.1  SX-WINDOW 概説」 （P.4) でも 述べた ように、 SX-WINDOW 
の プログラムは イベントを 中心に 動作して います。 そのため、 ほとんど 
の プログラムは Fig.  3-2 のよう な 構造を 持ち、 じ I 下に 示す ような 流れで 
化理を 斤い ます。 


〇 前化理 
変数の 初期化 

リソース ファイルの オープン、 ウィンドウの 作成な ど。 

〇 イベント ごとの 化理 

発生した イベントに 応じた 嫂理を 斤う。 

〇 後化理 

リソースの クロー ズ、 ウインドウの 破棄な ど。 


Fig.  3-2  •アプリ ケー シヨ ン のぶ 本 巧 造 


前 処理  - 

イ ベン ト 待ち— 

〇: 

’  お 処理  - 

スケルトン 部分 


アプリケーションに 
固有の 前 処理 


アイ ドル イベント 


マウス 左 ボタンダウン 


システム イベント 


アプリ ケーシ ヨンに 
固有の 後 処理 


アプリケーション じ 
固有の 部分 


- ► 処理の 流れ 

- - ♦ スケル トンから 呼び出す 


具体的に、 どのような 前 化理を 斤う か （どのような ウィン ドウを いく 
つ 開く 力 \ ボタ ンやス クロー ルバ ーな どの コント ロー ル アイテム も 作成 
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5)  "skeleton" とは、 英語で 
骨格を 意 ホし ます。 

6)  「呼び出す ピ け」 です。 
具体的 じどの よう な処 
理が 行われる かじつい 
ては スケル ト ンは 関知 
しません。 


する のか)、 個々 のイ ベン ト に応じて どのよう な 嫂理を 斤う のか （ボタン 
が 押されたら 音を 化すと か)、 どのよう な 後 化理を 行う のか （アプリ ケー 
ショ ン の化理 結果を 保存す ると か） じついて は、 アプリケーションに よっ 
て 違います。 

しかし、 どの SX-WINDOW プログラム も、 基本的に Fig.  3-2 のよう 
な 構造を 持って いる ことじ 変わりは ありません。 この 構造は、 いわば 
SX-WINDOW プログラムの 「骨格」 といえ ます。 

こ の 基本的な 骨格 部 かは、 どんな プログラム にも ある 程度 共通 します 
から、 新しい プログラムを 作成す るた びに 最初から 蕾く のは あまり 能率 
がよ いとは いえません。 そこで、 多くの プログラムに 共通す る 骨格 部分 
と、 個々 の プログラム 固有の 化理を 斤う 部 かとを 分離し ます。 この 骨格 
部分を 「スケルトン」 5) と 呼びます。 

スケルトン じは、 リソースの 才 ープン や、 イベント に応じて アプリ ケー 
ショ ン 固有の 化理を 呼び, |||| す6) などの、 アプリ ケー ショ ンに 依存し ない 
化理を 記述して おきます。 この スケルトンの 部分は、 一度 作成 すれば 何 
度で も 再 利用が 可能です。 

スケル ト ンに 含める ことができない アプリ ケー ショ ン 固有の 化理 （ウィ 
ン ドウの 作成な ど） は、 スケルトンとは 別に 記述し ます。 新しい アプリ 
ケー ショ ンを 作成す る ときは、 この間 有の 嫂理 部分の みを 斬た に 作成す 
れ ばいい わけです。 

化の 階膺 メニューを 扱った サン プル プ ログ ラ ムの 場合、 skeleton.  C 
が スケル ト ン じ、 sample  .  c が アプリ ケー ショ ン 固有の 部分に 相当し ま 
す。 それぞれを 少し 詳しく 见 ていく ことにしましょう。 


スケル トン 


スケルトン skeleton.  C を 詳しく 見て いきます。 

スケル ト ンで 斤う 化理 にはの^ 下の よう な ものが あり ます。 

〇 前化理 

- 変数の 初期化 

- SX-WINDOW の バージ ヨン チェック 
- リソース ファイルの オープン 
•コマンド ライ ンの 解析 
- アプリ ケー シヨ ン 固有の 前 化理を 呼び出す 
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〇 イベント ごとの 化理 

- イ ベン ト 待ちを し、 イベント に 応じた アプリ ケー ショ ン 固有の 処理 
を 呼び 化す。 

〇 後化理 

- アプリ ケー ショ ン 固有の 後 化理を 呼び 化す 
• リソー スフ アイ ルを クロー ズ する 

次に、 各項 目 ごとの 化理を 詳しく 見て いきましょう。 

t インク ルー ド ヘッダの 読み込み 

まず、 skeleton.c で 利用す る マネージャに 応じて、 SXSIKIT の イン 
クルー ド ヘッダを 読み込む 必 嬰が あり ます。 skeleton.  C でイ ン クルー 
ドへ ッ ダを 読み込む 部分を List  3-1 じ 示します。 


1  List  3-1 •  skeleton.  C： インク ルード ファイルの 読み込み  | 

15 

# include  <stddef.h>  ' 

16 

#ifndef  __LIBC__ 

17 

拌 1 凸 elude  <class.h> 

Kl) 

18 

#endif 

19 

#include  <SXDEF2.H> 

20 

21 

#include  <stdio  .]i>  'j 

1 

22 

#include  <stdlib.h>  . 

(2) 

23 

# include  <string.h>  J 

1 

24 

25 

#include  〈EVENT. H>  > 

26 

#include  <MENU.H> 

27 

#include  <SXGRAPH.H> 

28 

#include  <SXMEMORY.H> 

>  (3) 

29 

#include  く TASK.H〉 

30 

#include  〈WINDOW. H> 

7) ここでは  SXDEF.H, 
SXLIB.H のこと を 指す 


イ ン クルー ド ヘッダの 読み込みは、 大きく la 下の 3 段階に 分けられます。 
(1) 互換性の 維持 （15 〜 19 斤 II) 

Workroom じ I 前の ホい イ ン クルー ドへ ッ ダ7) や、 LIBSXC との 互換 
性を 維持す るた めの、 いわば おまじないです。 

な換 性を 考える 必要がない 場合で も、 とリ あえず、 このように 記 
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述 してく ださい。 

口） 標準 ライブ ラ リ 用の イ ン クルー ドへ ッ ダの 読み込み （21 〜 23 斤目） 
C 言語の 標準 ライブラリ を 利用す るた めの イ ン クルー ド ヘッダを 読 
み遂 みます。 当然、 この 部分は 使用す る 標準 ライブラリに よって、 
読み込む イ ン クルー ドへ ッ ダが 変わり ます。 

(3)  SX31KIT のイ ン クルー ドへ ッ ダの 読み込み （25 〜 30 行 目） 

アプリ ケー シ ヨンで 利用す る マネージャに 応じた SX31KIT の イン 
クルー ド ヘッダを 読み込みます。 この 部分 も 利用す る マネージャ じ 
よって 変わります。 読み込む 順番に ついて 特に 制限は ない ので、 必 
要な ものを 列挙す る だけで かまいません。 


0 変数の 初期化 

「1.1  SX-WINDOW 概説」 （P.4) で 述べた ように、 メモリ 使用 効率の 
面から 実 斤 プログラムは 極力 0BJR 型に する のが 理想です。 XC の 場合、 
C 言語を 使って 0BJR 型の 実 斤 プログラムを 作成す る 場合、 アプリ ケー 
ショ ンで 使用す る、 タスク ごとに 確保す る 変数を 1 つの 構造体と して ま 
とめて しまう 必要が あります。 


List  3-2  •  sample. h  : タスク ごとのを 数を 構造体 じ まとめる 

21 : tvpedef  struct  { 

22 :  int  quit ; 

23 :  int  EventMask ; 

24:  TsEvent  Event Re c; 

25:  Window*  WinPtr ; 

26:  Rect  WinRect ; 

27:  int  ActiveFlag; 

28:  int  虹 emiSell; 

29  :  int  皿 emiSel2 ; 

30:  }  glVal; 


さらに main 闕 数のと ころで、 この 構造体の 変数を ローカル 変数と し 
て 確保し ます。 ロー々 ル 変数と して 雜保 する ことで、 タスク ごとに 変数 
を 独立させる ことができます。 
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List  3-3  •  skeleton  : タスク ごとのを 数を 口ーカル ま! 数と して 確保す る 


65 :  main  (voia) 
66:  { 

(中略） 

76:  glVal  gv; 


しかし、 ロー々 ル 変数は 他の 関数から 参照す る ことができません。 それ 
では 困る ので、 各 関数の 引数に、 この 構造体への ポインタを 追加し ます。 
各 関数から はこの ポイ ンタを 経由 して ローカル 変数に アクセス します。 


[ List  3-4  •  sample .h  :  口ーカル ま! 数への ポイ ンタ を 引 おじ 加える 


36:  void  appTini  (int ,  glVal 本 j ; 
37:  int  appinit  ^^glVal*,  Rect*; ; 
38:  void  IdleEvent  (glVal*) ; 

39:  void  MsLDownEvent  (glVal*); 
40:  void  MsRDownEvent  (glVal*); 


0SX-WINDOW のバー ジョン チェック 

SX-WINDOW は バージョンが 上がる につれ、 さまざまな 機能が SX 
コールの 形で 追加され て きました。 

たとえば、 マルチ フォント テキストは ver.3.0 じ I 前の SX-WINDOW で 
は 使用で きないので、 アプリ ケー ショ ンで マルチ フォン トテ ネス トを使 
用す る 場合、 必ず バージ ョ ンを チェック しなければ なり ません。 

バージ ョ ン チェックは アプリ ケー ショ ンに 固有の 嫂理 のよう に 見え ま 
すが、 スケル ト ン 自体が 使用 している SX コールの なかに もバー ジョン 
に 依存す る ものが あり ます。 また、 SX-WINDOW  ver.3.0 じ I 降 と、 それ 
よ り 前と では 機能に 大きな 差が あり ます。 ユーザの なかには ver.2.0 を 愛 
用して いる 方 もい らっしゃる ようです が、 本書は 「SX-WINDOW  ver.3.1 
開発 ネット」 と 銘巧 っ ている ことから も わかる ようじ、 skeleton •  C で 
は ver.3.1 の L 降で あ る ことを チ 卫ック します。 


[ List  3-5  •  skeleton .  c  :  SX-WINDOW  の バー シヨ ン チェック 

82:  if  (SXVer  0  <  SXVER3) 

83:  { 

84:  DMError  (D_C0NFIRM, 

"SX-WINDOW  ver.3.1 が 降を 使用して 下さい。"）； 
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85:  return  — 1; 

86:  } 


バージ ヨンの チェックには タスク マンの SXVer 関数 を 使います。 skelet 
on.  C では SX-WINDOW のバ ージヨ ンが 古かった 場合、 ダイア ロ グ マン 
の DMError 闕 数で 瞥告 を, 中, して 終了す るよう になって います。 


0 リソー スフ アイ ルの 才ー プン 


8) コラ 厶 「リソ ー ス J を 

参照。 


アプリケーション リソース8) を オープン します。 そして、 リソースの 
ファイル 名を 決定し ます。 通常、 アプリケーションの 実 斤 ファイル 名の 
拡張 子を ".LB" じ 変えた ものを リ ソースの ファイル 名と します。 たとえ 
ば、 実行 ファイル 名が" キャンバス .X" なら、 リソース ファイル 名は" キャ 
ン バス .LB" となり ます。 


List  3-6  •  skeleton.  C :  •； ソー スフ アイ ル 名のを 更 

92:  TSGetTdb  (&tdb,  TS_0WN) ; 

93:  de 丄 etesufiix  (tdb .name ,  resFname) ; 
94:  strcat  (resFname,  " .LB") ; 


skeleton,  c では、 タスク マンの TSGetTdb 闕 数を 呼び 化して 実行 ファ 
イル 名を 取り出し、 その 拡張 子を ".LB" に 変更して います. 

リ ソース の ファイル 名が 決まったら、 タスク マンの TSResOpen 闡数 
を 呼び出して、 リ ソース ファイルを オープン します。 


[ List  3-7  •  skeleton. C :  ソー スフ アイ ルの 才ー プン 

99:  resHdl = TSResOpen  (resFname) ; 

100 :  if  (resHdl == NULL) 

101： { 

102;  DMError  (D.CONFIRM, "リ ソー スが才 ープン できません。"）； 

103;  return  -1; 

104:  } 


skeleton,  c では TSResOpen 関数の 返リ 値を チ 卫ック して エラーが 
起きた 場合には メ ッ セージを 出して 終了す るよう にして います。 
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©コラム： リ ソース 

SX- WINDOW に おける リソースと 
は、 簡単に いう と 交換 可能な 部品 （デ ー 
夕） のよう な ものです。 

たとえば、 ウィンドウ （を義 関数） がそ 
うです。 SX-WINDOW じは 数 種類の そ 
れぞれ 輿 なった 外見を 持つ ウィン ドウが 
あります。 ウィンドウの 外 兄を 描圃 してい 
るのは ウィン ドウ 定義 関数と 呼ばれる リ 
ソース で、 システムの リソー スフ ァイ ル 

(SYSTEM. LB) に 含まれて います。 もし 
ウィンドウの 外見を 巧え たければ、 この 
ウィン ドウ 定義 関数の リ ソースを 別の も 
のじ 交換し ます。 このと き齋 •き 横え るの 
はり ソース ファイル （中の リ ソ ース） だけ 
で、 SX-WINDOW の システム （FSX.X) 
自体を 書き換える 必 嬰は あり ません。 

ホに あなたが アプリ ケー シヨ ン を作っ 
ている 場合を 考えます。 ウィンドウを 開 
く 位置 や 大きさは、 プロ グラ厶 を 作成し 


ていくうち じ 何度と なく 変わる も のです。 
もし ウィン ドウを 開く 位-置 や 大きさを プ 
ログ ラ ム中 に 埋め込んで しまったら どうな 
るでしょう？ ウィンドウ の 位置 をち ょっ 
とを える だけで も プログラムを コンパイ 
ルし 直さなければ なリ ません。 これは 非 
常 •に 面 削です。 このような 場を、 ウィン 
ドウを 開く 位 證や大 きさと いっ た 憎 報を 
リソース として、 アプリ ケーシ ヨンの リ 
ソースファイル 中に 置く ようにし ます。 こ 
のよう じして おけば プログラムを コンパ 
イ ルし 直さなくても、 リソースを 変更す 
る だけで ウィン ドウの 位置を 手軽に 変え 
る ことができます。 

このよう に 変更され る 可能性の ある 部 
分を リ ソースと して プログラムから 切り 
離して おくと、 プログラムの 外見 や 振る 
舞いを 節 単に 変更で きる ようじな り ます。 


0 コマンド ラインの 解ネ斤 

SX-WINDOW の アプリ ケー シヨ ン では、 コマン ドライ ン から ウィン 
ドウを 開く 位置を 指定で きる ようになって います。 たとえば、 "キャン バ 
ス .X" じ 対して、 

^  キャンバス .X  -wlOO, 100,30 0,250 

と コマンド ラインで 指定す ると、 晒 面の 左上から （100, 10 0) の 化 霞に ウィ 
ン ドウが 200  X 150 ドット の 大きさ で 開 きます。 

この 化理は SX-WINDOW が やってく れる わけでは なく、 アプリ ケー 
シ ヨンが 自前で やらなければ なりません。 そのため、 このような 化理を 
支援す る SX コール TSTakeParam が 用意され ています。 

[ List  3-8  •  skeleton.  C  : コマン ド フイ ンの 解が  j 

1 丄 /:  ret  =  TSTakeParam  (.tdb .  command,  &winRect ,  NULL,  0,  NULL, 
NUL。 ； 
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if  ((ret  色 1) ==  0) 

{ 

/* ウィンドウ 位置 指定がない*/ 

winRect .1 .l_t  =  TSGetWindowPos  () ; 

winRect .d. right  二  winRect . d. left  +  WIN_XSIZE; 

winRect .d. bottom  =  winRect .d. top  +  WIN_YSIZE; 


タスク マンの TSTakeParam 関数に コマン ドラ インを 引数と して 渡す 
と、 コマンド ライン 中に "-W" オプシ ヨンに よる ウィン ドウ 位置の 指定 
がない かどう かを チ ユックし、 その 結果を レク タング ルと して 返します。 

skeleton.  C では さ ら に、 "-to" オプシ ヨンに よる ウィン ドウ 位置の 
指定がなかった 場合、 タスク マンの TSGetWindowPos 関数を 利用して 
適当な ウィン ドウ 位置を 取得して います。 

0 アブ、) ケー シヨ ンに 固有の 前 処理を 呼び出す 

前 化理の 最後に、 アプリ ケー シヨ ンに 固有の 前 化理を 呼び出します。 
すでに 述べた ように、 アプリ ケー シヨ ン 固有の 部分で 具体的に 何が 斤 
われる かにつ いては、 スケル ト ンの 側は いっさい 関知す る 必要が ありま 
せん。 そのため、 基本的には アプリケーション 固有の 前 処理を 斤う 関数 
を 呼び出す のみです。 


[ List  3-9  •  skeleto 且 . C : アプリ ケー シヨ ン 固有の 前 処理を 呼び出す 

130 :  if  ( ! applnit  (色 gv, 色 winRect)) 

131；  { 

132:  DMError  (D.RED  I  D.CONFIRM, "アプリ ケーン ヨンの 初期化に 失敗し 

ま した。"）； 

133 :  TSResRemove  〇; 

134  :  appTini  (-1,  &gv) ; 

13d :  return  —1; 

1%:  } 


skeleton,  c では、 アプリ ケー シヨ ン 固有の 前 化理で エラー が 起きた 
場合を 想定し、 エラー カぶ 起きた 場合には メ ッ セージを 出して 終了す るよ 
うに しています。 


8  9  0  12  3  4 

112  2  2  2  2 

11  IX  IX  1±  1i 
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0 イベントに 応じた 処理 

SX-WINDOW アプリ ケー シヨ ンの 中心で ある イベント に 応じた 化理 
の 部分です。 

ここでは、 タスク マンの TSEventAvail 関数を 呼び 比 して イベントを 
待ち、 さらに イベント に 応じた アプリ ケー シヨ ンに 固有の 化理を 呼び出 
します。 


[ List  3-10  •  skeleton.  C  :イ ベン ト 待ろ ルー プ 


144 

145 

146 

147 

148 

149 

150 

151 

152 

153 

154 

155 

156 

157 

158 

159 


while  ( ! gv.quit) 


TSEventAvail  (gv. EventMask,  fegv.EventRec； ; 
switch  ( gv. Event Rec.ts .what) 

{ 


case  E_IDLE: 
case  E.MSLDOWN: 
case  E.MSRDOWN: 
case  E.KEYDOWN: 
case  E_UPDATE : 
case  E.ACTIVATE: 
case  E.SYSTEMl : 
case  E_SYSTEM2: 
default : 


IdleEvent  (&gv) ;  break; 
MsLDownEvent  (&gv) ;  break; 
MsRDownEvent  (狂 gv) ;  break; 
KeyDownEvent  (色 gv) ;  break; 
Update Event  (色 gv) ;  break; 
ActiveEvent  (色 gv) ;  break; 


break; 


} 


イ ベン トに 応じた アプリ ケー ショ ンじ 固有の 化理 部分は、 実際には 
sample.  C の ほう に 記述され ており、 skeleton,  c では プロ ト タイプの 
宣言の み 行って います。 

ここで も アプリ ケー ショ ン 固有の 部分で 具合 的に 何が 斤 われる かにつ 
いては、 スケル ト ンの 側は いっさい 関知して いない ことじを 意して くだ 
さい。 


9 アプリケーションに 固有の 後 処理を 呼び出す 

アプリ ケー ショ ンに 固有の 前 化理を 呼び出した ときと 同様に、 アプリ 
ケー シヨ ンに 固有の 後 化理を 呼び出します。 
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List  3-11 •  skeleton.。 アプリ ケー シヨ ン 固有の 巧 処理を 呼び出す 


165 :  appTini  (0, 色 gv) ; 


9)"Tini" は "Init" を 
逆に 並べた ものです。 
前 処理が Init なので、 
後 処理は Tini という 
わけです。 


後化理 appTini 関数9) で エラーが 発生す る こと も 考えられ ますが、 結 
局、 アプリ ケーシ ヨンカ 《 終了す る ことじは 変わりは ない ので、 skeleton.  C 
では エラー チェックを していません。 

0 リソース ファイルを クローズ する 


アプリケーション リソースを クロー ズ します。 これは、 単純に タスク 
マンの TSResRemove 関数 を 呼び出す だけです。 


[ List  3-12  •  skeleton. C: り ソースファイルを クロー ズ する 

170 :  if  (ResHdl) 

171 :  TSResRemove  〇; 


©C 


アプリケーションに 固有の 部分 


それでは、 アプリケーションに 固有の 部分 sample. C を 詳しく 見て い 
きます。 

アプ リ ケー ション じ 固有の 部分で 斤う 化理に はじ I 下の ような ものが 考 
えられます。 


〇 前化理 

変数の 初期化、 メニュー、 ウィンドウの 作成な どを 斤う。 

〇イ ベン ト化理 

個々 の イベント に 応じた 化理を 斤う。 

〇 後化理 

メニュー、 ウィンドウの 破棄な どを 行う。 

ここ に 挙げた 処理は サ ン プル プロ グラムで 斤って いる も ので、 実際に 
は 個々 の アプリケーション によって 千 差で 別です。 そのため、 この 後、 各 
項目 ごとの 化理を 見て いきます 力ぶ、 詳細には ふれません。 みなさんが ア 
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プリ ケ ーショ ンを 作成す る 場合には、 自分の 力で プログラムを 組み立て 
ていかなければ なり ません。 

9 前 処理 

アプリ ケー ショ ンじ 固有の 前 化理は sample.  C の appinit 関数で 斤つ 
ています。 ここでは、 まず アプリケーションに 固有の 変数の 初期化を 斤 
います。 

次に、 アボート 化理を 斤う 関数を 登録し ます。 アボート 化理 関数とは、 
なんらかの 理由で SX-WINDOW の システム じ 異常が 生じ、 アプリ ケー 
ショ ンの実 斤を 中断し なければ ならない ときに 呼び 化される 関数です。 

アボート 化理 関数では、 通常の アプリ ケー ション 終了 化理と 同等の 化 
理を 斤えば よい こと が 多く、 sample.  C でも アプリ ケー ショ ン 固有の 後 
化理を 斤う appTini 関数を アボート 化理 関数と して 登録して います。 


List  3-13  •  sample. C: ァボー ト 化巧閒 数を 登録す る 
166 :  TSSetAbort  (appTini ,  Qong)  &  gv) ; 


10) 従来の WMOpen と、 
新しい WM0pen2 と 
WHOpen とでは 引数が 
若干 変わって います。 


次に ウィン ドウを 開きます。 sample.  C では ウィン ドウに 関して 特別 
な ことは していな いので、 単純に ウィン ドウ マンの WM 邸 en2 関数 i のを 
呼び出 して ウィ ン ドウを 開いて います。 

[ List  3-14  •  sample  .c: ウインドウを 瞄く  | 


181 : gv->WinPtr  =  WM0pen2  (NULL,  &gv->WinRect ,  winTitle,  0, 

182:  WI_STD2,  0,  (Window*) -1, -1, TSGetID  ()); 

183 :  if  (gv->WiiiPtr  ==  NULL) 

184:  { 

185：  DMError  (D_RED  I  D.CONFIRM, "ウインドウが 作成で きません。"）； 

186 :  return  0 ; 

187:  } 


g 個々 の イベントに 応じた 処理 

アプリ ケー ショ ンに 固有の 部分では、 アイ ド ルイ ベン トや マウ スイべ 
ン ト などの 個々 の イベント じ 応じた 化理を 記述し ます。 これらの 化理 は、 
すでに 述べた スケル ト ン から IdleEvent や MsRDownEvent などの 闕数 
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名で 呼び 化されます。 が応 する 必要の ない イベントに ついては、 何もし 
ない 関数を 用意して おきます。 

ここでは、 サンプル プログラムで 特徴 的な マウス ライ ト ダウン イ ベン 
卜 について のみ 説明し ます。 

マウス ライ ト ダウン イベント の 嫂理は MsRDownEvent 関数で 斤 われ 
ます。 

まず、 発生した イ ベン トが 本当に 自分の ウィン ドウに 対する もの かど 
うかを チ ユック します。 


[ List  3-15  •  sample .  c : 自 々のウ インド ウ への イ ベント かどう かを 巧 かめる 

251 : II  ^^gv— >EventRec.ev.whom.wio  ! == 邑 v— >WinPtr) 


次に、 イ ベン トが 発生した ときの マウス ポイ ンタの 座標から 表示す ベ 
き メニューを 決定し ます。 サンプル プログラムでは、 マウスの 右 ボタン 
を 押す 場 戸 斤に 応じて 2 種類の メニュー のうちの 1 つが 表示され ます。 


[Ust  3-16  •  sample. C: 右 ボタンが 巧され た 巧 所を 巧 かめる 

85:  pt  =  GMGlobalToLocal  i,gv->EveiitRec .  ev .  where .  x_y) ; 
86:  if  (GMPtInRect  (femenuRectl , pt) ) 

87;  { 

88:  皿 emiStr  =  menuStrl ; 

89:  皿 emiSei  = 色 gv->menuSell ; 

90:  } 


イ ベン トの 発生した マウス 座標は イ ベン トレ コー ド 中に あ ります。 この 
マウス 座標は グローバル 座標系な ので、 グラフマンの GMGlobalToLocal 
関数で ローカル 座標系 じ 直す 必要が あり ます。 

グラフマンの GMPtInRect 関数で、 どちらの メニ ューを 表示す るかを 
決定 します。 

表示す べき メニュー が 決 まったら、 メニュ ー レコ ー ドを 作成 します。 こ 
れ には メニュー マンの MNConvert2 関数を 利用し ます。 


[ List  3-17  •  sample. C:  メニユ ー义宇 列から メ ニユー レコー ドを 作成 

102:  menuHdl = MNConvert2  (NULL,  menuStr ,  M し PLN) ; 

103:  if  (menuHdl == NULL) 

104:  { 

105:  DMError  (D.RED  I  D.CDNFIRM,  "メニ ユーが 作成で きません。"）； 

106  :  return ; 
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最後に メニュー レコ _ ドに 従って メニューを 表示、 メニュー アイテム 
の 選択を します。 メニューの 表示、 選択と いう 一連の 化理 は、 メニュ ー 
マンの MNSelect 関数を 利用し ます。 


[ List  3-18  •  sample .  c:  メ ニューの 表示と セ レクト 化 巧 


110  :  幸 menuSel = MNSelect  (皿 enuHdl,  gv->EventRec.ev.w 丘 ere.x  v) ; 
111:  MMHdlDispose  ((Handle)  menuHdl) ; 


選が された メニュー アイテムの 番号が、 MNSelect 関数の 返り 値と な 
り ます。 

> 後 処理 

一般に 後 化理で 斤う ことは、 前 処理で 斤った ことに それぞれ 対応し 
ます。 sample.  C でも 同様で、 アプリケーションに 固有の 後 嫂理を 斤う 
appTini 関数では、 appi 已 it 闕 数で オープン した ウイン ドウを クロー 
ズ しています。 


r  List  3-19  •  sample .  c : ウインド ウの鹿 ま 

142 :  if  (gv->WinPtr) 

143  :  WMDispose  (gv->WiiiPtr) ; 


11) 仁 泉 大輔氏 作の 超 高 
機能 スケルトン。 ホせ 
CD-ROM じ 収録され て 
います。 


ここで 紹介した スケル ト ンは 説明の ための 非常に プリ ミ ティ ブな もの 
です。 SX-WINDOW プロ グラミ ングに 不慣れな 人は、 ここで 紹介した ス 
ケル ト ンや 他の サンプル プログラムを 改造したり、 少しずつ 機能を がけ 
足したり していく のがよ いでし ょう。 そうする ことで SX-WINDOW に 
対する 理解が よ り 深まり ます。 

も っと 実用的な アプリ ケー シヨ ンを 作成す る 際は、 Method- SXii) など 
の 高機能の スケル ト ンを 利用し、 アプリ ケー シヨ ン 固有の 化理 部分の 作 
成に 力を をぐ よう にす る とよいで しょう。 
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SX-WINDOW  3.1 環境での 
プロ クラ 5 ンク例 


本節では、 SX-WINDOW  ver.3.0 じ I 降で 拡張 あるいは 追加され た マネー 
ジャ のうち、 グラフ ィッ ク 画面に 関する ものに ついて 解説し ます。 
グラフィック 画面に 関する 拡張には、 

〇 グラ フィック ウィンドウ による 65 が 6 を 表示への 対応 

〇 静止 顿像 データの 仲 張/圧縮の サポート 

1)CGA:  Computer  Graphic  〇 アニメ ー シヨ ン動顾 に GA)1) の 再生/作成 

Animation 

が あり ます。 

これらの お 張に ついて 詳細に 説明す るのは 紙幅の 都合 上 不可能な ため、 
サンプル プログラムを 例に した 概説と いう 形式を とりま した。 

本書の 添付 FD じは、 各 サンプル プログラムの ソースファイルと 実行 
ファ イ ルが 収め られ ています。 実際に サンプル プロ グラムを 実行したり、 
ソースファイルを 参照したり しな 力 ぶら、 な 下の 説明を 読む ことを お勧め 
します。 


グラフィック クイン ドク 


SX-WINDOW  ver.3.0 では、 65 が 6 色の 表示が 可能な グラ フィック ウィ 
ン ドウが 用意され ま した。 それまで グラフィック 画像は 16 色まで しか 表 
示で きず、 65 が 6 色の グラフィック 画像を 表示す るに は 減を 化理 をす る必 
要が ありま した。 

新しく 用意され た グラフィック ウィン ドウは 768  X  512 ドッ トの 画面 
モードで、 512  X  512 ドットの 範囲 内で 自由な 大きさの 65,5% 色 グラフ イツ 
ク 画像 表示が 可能です。 

參 GRW.X 
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3-2  SX-WIND0W3.1 巧 巧での フ ログ ラミング 例 


の 独立した アプリ ケー シヨ ン によって 実現され ています。 


F お.  3-3  •  GRW.X は 画面の 中の 画面？ 


2) コラム 「階層 ウィンド 
ウ」 （P.94) を 参照。 


GRW.X を 起動す ると、 Fig.  3-3 のよう な グラフィック ウィン ドウが 現 
れ ます。 よく 見る と、 ウィンドウの 外枠が 今までの ものと 違って いる こ 
とがわ か ります。 

ここで キャンバス .X を 起動す ると、 もう 1 つの 違いに 気づき ます。 
Workroom の ウィン ドウが グラフィック ウィン ドウの 中に 現れる のです。 
さ らじ キャンバス .X の ウィン ドウを 移動して みると、 グラフィック ウィン 
ドウに よって クリッピングされ ている ことが わかります。 つまり、 ウィ 
ン ドウが 階層2) になって いるので す。 

さて、 キャンバス .X のよう じ グラフィック ウィン ドウの 中に 子 ウィン 
ドウを 開き、 グラフィックを 表示す るには どのよう に すれば よいので しょ 
う 力 グラフィックの 表示に ついては、 静止画 像 や アニメーション 動画 
の 解説で 具体的に ふれる ことにして、 ここでは グラフィック ウィンドウ 
の 中に 子 ウィン ドウを 開く 方法の みを 説明し ます。 
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©コラ 厶： 階層 ウィンドウ 


階層 ウィン ドウを 一言で 説明す ると、 
「ウイン ドウの 中 じ ウイン ドウが あって、 
その 中に さらに ウィンドウが あって…」 と 
いう ことです。 

たとえば Fig.  3-4 では、 ウィンドウ A 
の 中に ウィンドウ B が あって、 その ウイ 
ン ドウ B の 中に さらに ウインドウ C が 
あります。 また、 ウィ ン ドウ C は ウィン 
ドウ B じよって クリ ッ ピン グ され、 右 丄 
の 部分し か 見えて いません。 

それにが して Fig.  3-5 は、 階層 ウィン 
ドウでは ない 例です。 ウィンドウ E は ウィ 
ン ドウ D によって クリ ッ ピン グ されて い 
ます 力、*、 ウィンドウ D の 中に ウィンドウ 
E が ある わけでは あり ません。 

このように ウィン ドウが 階/巧のに 配 衛 
されて いる 場合、 ウィンドウ 間の 上下 脚 
係が 重要に なり ます。 この 階 胸 ウィンド 
ウ の 上下関係 は 親子関係 じ なぞらえられ 
る ことが 多く、 「親 ウィンドウ」、 「子 ウィ 
ン ドウ」 という 呼び 方を します。 

Fig.  3-4 の 例では、 A が 旣ウ ィン ドウ 
で、 B が子ウ ィン ドウと なります。 同様 
に、 B 力ぶ 親 ウイン ドウで、 C 力ぶ 子 ウインド 
ウ です。 親子 I 绍 係は 梢が 的な ものです か 
ら、 B は 親で あると 巧晴に 子で も ある わ 
けです。 また、 A を 親 ウィンドウ とした 
とき、 C を孫ウ インド ウと 呼ぶ こ とも あ 


ります。 「親 窜の巧 中に 子 絶を 載せて〜」 
という わけです。 


F お.  3-4  ■ 階ち ウイン ドウの 例 
ウイ バウ A 


ウイン ドク B 

ヴィン ドク C 

の护 3-5  ■階 巧 ウイン ドウでは ない 例 


クイン ドク 己 

ウィンド 勺 E 

ウイ シド ウ E 


0 グラフィック ウィンドウの 開き 方 

先 ほど 述べた ように、 65 が 6 色 表示を 司る GRW.X は 1 つの 独立した ア 
プリ ケーシ ヨンです。 SX コー ルの 形で 実装され ていないので、 その 利用 
に は 若干 変則 的な 方法 を 用います。 じ I 下 に その 手順を 示します。 

① タスク 間 通信で GRW  •  X の ウィンドウ ポインタを 取得す る 

これから 開こう としてい る グラフィック ウイン ドウは 階層 ウイ ン ドウ 
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ですから、 親 ウィン ドウへの ポイ ンタが 必要と なり ます。 親 ウィンドウ 
は GRW.X の ウィン ドウです から、 どう じかして GRW.X の ウィン ドウへ 
の ポインタを 知る 必要が あり ます。 それには タスク 間 通信を 用います。 


Fig.  3-6  •  GRW.X との タスク 間 通信 


アプリケーション 

ウインドウ ポインタを 
要 ホす る 

—  - - 

GRW.X 

ウイン ドウ ポインタを 
あす 


Fig.  3-6 のよう じ、 GRW.X の ウィン ドウの 中に グラ フィック ウィンド 
ウを 開きたい アプリ ケー シヨ ンの 側から メ ッ セー ジを 送り ます。 


[Ust  3-20  •グラフィック ウィン ドウを 關く アプリ ケーシ ヨンから メッセー ジを 送る 

1： TSPostEventTsk  (WR.GROW,  WR.WIND,  REQRESPONSE,  0,  0) ; 


GRW.X 力ぶ 起動され る タイ ミン グは 不定です から、 通信 相手の タスク ID 
を 指定す る ことは 不可能です。 そのため、 TSPostEventTsk 関数を 用い、 
すべての タスクに 対して メッセージを 送ります。 REQRESPONSE は、 返信 
要求の ある 通信を 示す イ ベン ト です。 ここでは WR_GRTO， WR_WIND を そ 
の 引数と する ことで、 GRW.X に対して ウィン ドウの ポイ ンタを 返信す る 
よう じ 嬰 求して います。 

③ 次に GRW.X からの 返信を 待ちます。 

返信を 待つ 手順は 通常の タスク 間 通信の 場合と 同様、 TSEventAvail 
関数で イベント 待ちの ループを 作ります。 アイドル イベントは、 GRW.X 
が 起動して いない ことを 意睐 します。 この場合は、 グラフィック ウィン 
ドウを 開く ことは できません から、 「GRW.X 力ぶ 起動して いない」 という 
エラー メ ッ セージを 表示す る ダイアログを 出して 終了す るか、 あるいは 
自前で GRW.X を 起動し ます。 

GRW.X との 通信に 成功す ると、 システム イベントの RESPONSE が圃っ 
てきます。 この場合、 イベント レコードの whom を 見て、 相手が GRW.X 
である ことを 確認した あと、 イ ベン トレ コードの wliom2 を GRW.X の ウィ 
ン ドウへの ポインタ として 利用 します。 
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③ 階層 ウィンドウを 開 〈じは、 新しい SX コール WH 邸 en を 用います。 

WHOpen は 親 ウィン ドウへの ポイ ンタが 引数に 加わった じ 1外、 従来の 
WMOpen と 同じです。 親 ウィン ドウへの ポイ ンタ には 先 ほど 取得した GRW  •  X 
の ウィンドウへの ポインタを 指定し ます。 また、 ウィンドウ 定義 関数の 
ID には WIN_CHILD を 使用 します。 


List  3-21 •  WHOpen で 階 « ウインドウを 開 < 


1 : WHOpen  (gv->pWiii,  NULL,  &gv->wiiiRect ,  gv->winTitle ,  0, 

2:  WIN-CHILD,  W.SBGX,  (Window  *) -1, -1, TSGetID  ()); 


WHOpen で 作成 した ウィンドウ に 対 しては、 従 米の WMOpen で 作成し 
た ウィンドウと 同様の 扱いを する ことができます。 たとえば、 ウィンド 
ウ 内部の アップ デー トの 際は WMUpdate/WMUpdtOver を、 ウインドウの 
破棄には WMDispose/WMClose を 使います。 

List  3-22  •  GRW.X からの あなを 待つ ブロ グラム 例 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 
29 


flag  = 1; 
while  (flag) 

{ 

TSEvent Avail  (EM.EVERY ,  &gv->myEvent) ; 
switch  (gv-> 田 y Event .ts .what) 

{ 

case  E_IDLE: 

/* 

幸 E.IDLE イベントが 回って きたら GRW はいない。 

*/ 

flag  =  0; 
break j 

case  E.SYSTEMl : 
case  E_SYSTEM2: 

switch  (gv— > 曲 yEvent .ts.whsLtS) 

{ 

case  ENDTSK : 

EndProc  (0,  gv) ; 
break; 

case  RESPONSE: 

/* 

幸 GRW から 返事が あった。 

幸/ 

if  (gv->myEvent . ts . whom  ==  WR_GR0W) 

{ 

/* 

*  GRW の ウィンドウ ポインタを 得る。 

*/ 

gv->pWin  =  (HWindow 幸） gv->myEvent . ts . who 皿 2 ; 
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30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 


flag  =  0; 

} 

break; 
default : 
brecLK；; 

} 

break; 
deiault : 
break; 

} 


0 グラフィック ウィン ドウを 使った サンプル プログラム 

グラフィック ウィン ドウの 利用は、 それだけでは 単独の アプリ ケー ショ 
ン にはなら ず、 あく まで 他の アプリ ケー ショ ンの 一部3) となるべき 性格 
の ものです。 そこで、 グラフィック ウィンドウを 使った サンプル じついて 
は、 ここでは 紹介し ません。 そのかわり、 この あとで 登場す る 静止画 像 
の 再生 や アニメーション 動画の 再生の サン プル プ ログ ラム 中で グラフ ィッ 
クウ イン ドウを 利用して いますので、 そちらを 参照す るよう にして くだ 
さい。 


静止画 像 デ™ 夕の 伸張/圧縮 


3) キャンバス .X や CG ビ 
ジョ ン .X がよ い 例で 
す。 


4) モジ ュール じついて は 
コ ラム 「IVM と 画像 モ 
ジュー ル」 （P.98) を 参 
照。 


5) アニメー シ ヨンと 同じ 
要領で 動画を 実現して 
います。 


SX-WINDOW  ver.2.0 までは グラフ ィ ック 画面が 16 を モードの みだ っ 
たため、 画像 データの フォー マッ ト としては PIX 形式の みが サポート さ 
れ ていました。 そのため、 PIC 形式な どの X680x0 では 比較的 メジャー 
な フォー マッ トの 画像を 扱う には、 自前で 画像 ファイルの 伸張 ルーチン 
を 書いたり、 65,5% 色から 16 色への 減 色を 斤う 必要が ありま した。 

SX- WINDOW  ver.3.0 では、 従 米の  PIX  形式に 加え、 TIFF,  JPEG,  PIC 
といった、 X680x0 でよ く 利用され る 画像 フォー マッ トがサ ポー ト され 
ました。 これらの フォー マッ ト に対する 伸張/圧縮 ルー チンは それぞれ モ 
ジュール として 独立して おり、 高機能の モジ ュー ルへの 差し替え や、 新 
しい モジュールの 追加が 簡単に できる よう じ 配慮され ています4)。 あと 
で 述べる 動画 像に おいても、 1 枚 1 枚の 画像は 静止画 像5) として 扱われ 
ます。 
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©コラ 厶 ： IVM と 画像 モジ ユール 

ビデオ マネー ジャ (IVM.X) は、 名 •画像 
形式の 伸張/圧縮 プログラム （モジュール) 
を IVM.LB 中に コー ドリ ソースと して 管 
理 しています。 画像 形式 ごとに VMIF と 
VMEC という 2 種類の リ ソース タイ プが 
あります。 

VMIF は、 各 画像 形式の フォーマット 
チェック や 画像の 大きさ、 を 数等の 情報 
取得を 行います。 一方、 VMEC は奖 際の 
仲 張/圧縮を 斤い ます。 

画像 モジ ュー ルは リ ソース です ので、 


ユーザが 自由に 交換- 追加を 斤う ことが 
できます。 本書では 画像 モジ ュー ルの 詳細 
や 作成 方法は いっさい 説明し ません。 そ 
のか わり、 すで じ フリーソフト として 配 
布され ている いく つかの 画像 モジ ュール 
を 添付 CD-ROM に 収録 してあります。 
そのうちの いく つかの 画像 モジ ュー ルに 
ついては ソ ー スコ ー ド も いっしょ に 収録 
してあります ので、 そちらを 参照す るよ 
うにして ください。 


これら 静止画 像 および 動画 像に 関する 化理 は、 IVM.X という プロ グラ 
ム によって 実現され ています。 IVM.X は 「ビデオ マネージャ」 と 呼ばれ、 
フォン ト マネージャ IFM.X と 同様、 SX シェルから 起動して 常駐させる 
ことで、 SX-WINDOW の 機能を お 張し ます。 

ここ では 画像の 仲 張/圧縮の 手順を 示す とともに、 「グラ フィック ウィン 
ドウ」 の 項では ふれなかった グラフィックの 表示 方法を 説明し ます。 なお、 
じ [後、 特に 必要の ないかぎ り、 静止画 像を 単に 「画像」 と 表記し ます。 

t 画な の 伸張 

.画像の 伸張の 手順を i^:rF に 示 します。 

① 画像 ファイルを メモリ 上に 読み込む 

最初に、 画像 ファイルを メモリ 上に 読み込みます。 読み込む 先は ポイ 
ンタ でも ハンドル でも かまいません。 ポインタの 場合、 あとで 疑似 ポイ 
ンタと して 扱います。 ここでは 画像 ファイルを ハン ドル じ 読む 込む こと 
にします。 

まず、 画像 ファイルを 開き、 ファイル サイズを 調べます。 


[list  3-23  • 画像 ファイルを 開き、 ファイル サイズを 巧べ る 

1: fh  =  TSOpen  ("SAMPLE. PIC" ，  0); 

2:  fsize  =  SE 邸 （fh,  0，  2); 

3:  SEEK  (fh,  0,  0); 
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調べた 画像 ファ イ ルの 大 きさの ハン ドルを 確保 します。 


buf  =  MMChHdlNew  (f size) ; 


確保した ハン ドルを ロックし、 実際に ファイルを 読み込みます。 

MMHdlLock  (buf); 

READ  (fh,  ♦buf,  f size) ; 

最後に ファイルを 閉じます。 

TSClose  (fh); 

ここでは 説明の ため、 細かい エラー チェックは 省略して います。 

③ 画像 ファ イ ルの 情報を 得る 

次 に ①で読 み 込ん だ 画像 ファイル に関する 情報を 得ます。 

画像 ファイルの 情報は 構造体 VideoInfo によって 表され、 画像の 形 
式、 サイズ、 色 数、 ハ。 レットな どを 含んで います。 

構造体 Videoinfo の各メ ンバ とその 内容を じ [下に 示します。 


化 ble  3-3  •  Videoinfo のを メ ンバと 内容 


型 

メ ンバ名 

内  容 

long 

rscID 

モジュールの リ ソース ID 

char 

idName  l!32] ; 

モジ ュール 名 （ASCIIZ 型） 

char 

idData[128] ; 

モジュールに 閒 する 情報 

char 

expFName [4] ; 

標準の 拡張 子 

short 

forPhoto; 

VMGetInf 0 が 可能 かどう か 

short 

f orMovie ; 

VMRegistSample が 可能 かどう か 

short 

withHeader ; 

画像 形式を 識別 する へッ ダが つ いている か 否か 

short 

f ixedBounds ; 

画像の レク タン グルが 固定 かどう か 

これより 上は、 必ず 格納す る 領域 


short 

bitsType; 

最適な スク リーン タイプ 

short 

useBits ; 

色を 表現す るのに 必要な ビット 数、 フル々 ラーは一 1 

short 

withPalette ; 

パレ ッ トを もつ かどう 力 > 

Rect 

baseRect ; 

想 1 定 されて いるべー ス 画面の レク タング ル 

Rect 

picRect ; 

実際の 刚 像の レク タング ル 

long 

expTime ; 

伸張に 必要な 時間 

char 

reserved [38] ; 

システム 予約 

char 

user  [16] ; 

モジ ュー ルに 固有の 領域 

実際に ①で 読み込んだ 画像 ファ イ ルの 情報を 得る には、 読み込んだ メ 
モ リ への ハン ドルと、 画像 ファイルの ファイルネームへの ポイ ンタを 引 
数と して、 VMGetInfo 関数を 呼び出します。 
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List  3-24  •  VMGetInfo 閒 数の 呼び出し 


1 :  Videoinfo  info; 

2:  modulelD  =  VMGetInfo  (-1, buf ,  filename, 色 info,  0) ; 
3:  if  (modulelD  <  0) 

4:  { 

5：  T 沈 rrDia：LogN  (D_C 日 NFIRM, 

6:  "サ ポート されて いない データ 形まで す。"）； 

7:  } 


画像 ファイルの 情報 取得に 成功す ると、 VMGetInfo 関数は 返り 値と し 
て 1 の の 値を 返して きます。 この 値を 「モジュール の」 といい、 画像 
の 形式を 表します。 モジ ュール ID の 値は、 この あとの 伸張で 使います。 

画像 ファイルの 情報 取得に 失敗す ると、 VMGetInfo 関数は 負の 値を 返し 
てきます。 この場合、 IVM で サポートし ていない 画像 形式 か、 あるいは 画 
像 ファイル カな 衷れ ている ことが 考えられます。 Table  3-4 に SX-WINDOW 
ver.3.1 で 正式に サポートされ ている モジュール ID と 画像 形式 および そ 


の 標準 お 張子の 対応を 示します。 


Table  3-4 参 モジ ュール ID と 画が お ま- 掘 巧 子の 対応 


モジ ュール ID 

画像 形 ま 

扼 張子 

1 

TX16 16 色 

PIX 

2 

EasyPaint  16 色 

PNT 

3 

PAT4 パターン エディタ 

PT4 

4 

ベタ （256x256 ドット） 65,536 色 

GL0 

5 

ベタ （512x512 ドット） 65,536 色 

GL3 

6 

ベタ （任意 サイズ） 65,536 色 

GLM 

7 

Run  length  Pixel  Cham 

RPC 

8 

JPEG  caseline  DCT 

JPG 

9 

TIFF モト ロー ラ 

TIF 

10 

TIFF インテル 

TIF 

11 

APIC 16 〜 65 が 6 色 

PIC 

12 

画像 ファイル （D5GA) 

PIC 

13 

IBit-per-pixel  gray  scale 

OBM 

6) グラフィック タイプの 
Bits。 I ドッ ト じつき 
2 バイ ト なので 65,536 
をまで 表現 可能。 


④ 画像を 伸張す る 

⑤で 得られた 情報を もとに VMExpand 関数を 呼び 化 して 画像を 仲 張し 
ます。 

画像を 伸張す る 先は Bits です。 Bits には G.GRP タイプ6) の ものを 
自 前で 確保す るか、 NULL を 指定 して 自 動的 じ 確保 しても らう 力 \ どちら 
かの 方法を とリ ます。 いずれ じせよ、 G_GRP タイプの Bits に 画像が' 伸 
張され る ことにな り ます。 

ここでは NULL を 指定し、 自 動的に 確保す る ことにします。 
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[List  3-25  •  VMExpand 関数 じよ る 画な の 伸張 

1  :  Bits キ幸 img; 

2  :  img  =  VMExpand  (NULL,  buf ,  rscID, 狂 i 凸 f o . picRect , 

3  :  feinfo .picRect ,  0); 

4 :  if  (img  ==  NULL) 

5:  { 

6:  TSErrDialogN  (D.CONFIRM, "デー タの 伸張に 失敗し ました。"）； 

7:  } 


VMExpand 関数の 返り 値と して NULL 力ぶ 返 っ てき た 場合、 画像の 伸張 
中に エラーが 発生した ことを 表します。 


t 画像の 表示 


次に、 伸張した 画像を 65,536 色の グラフィック ウィン ドウに 表示し ま 
す。 グラフィック ウィ ン ドウを 開く 手順は 「グラフィック ウィ ン ドウ」 の 
て 頁を 参照して ください。 ここでは、 すでに グラフィック ウィンドウが 開 
いている ものと します。 

まず、 ウィンドウの 内部の テキスト 画面を 透明 色で 塗りつぶします。 こ 
れ は、 テ ネス ト 画面が グラフィック 画面よ り 表示の 優先順位が 高いた め、 
透明 色で 塗りつぶして おかないと グラフィック 画面が 見えない からです。 


[list  3-26  •テキス ト 画面の 塗りつぶし 

1： GMAPage  (15) ; 

2:  GMForeColor  (G.THRU) ; 

3:  GMPenMode  (G.PSET) ; 

4  :  GMFillRect  (&gv->winPtr->graph. rect) ; 


次に ウィン ドウの Bitmap を グラフィック タイプに 差し替えます。 テ 
キ スト 画面では なく、 グラフィック 画面に 描画した いのです から、 必ず 
差し替えます。 


[List  3-27  • グラフィック 画面への 差し替え 


1 :  Bitmao 幸  txtBmap; 

2:  txtBmap  =  GMMakeGrpBit 面 ap  〇; 


65,5% 色 用の ノ、 。レッ トを 用意し ます。 
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List  3-28  •  65,536 色 パレ ッ ト のを 備 


1 : Palet**  pit; 

2:  pit  =  CLRefer  (PALT_G65536) ; 


先 ほど 画像を 伸張して おいた Bits を ロックし、 実際に 描画を します。 
描画には GMCopy2 関数を 用います。 


List  3-29  • 画な の お 画 


1 : GMLockBits  (img) ; 

2:  srcBmap  =  & (幸 i 扭居 ク omap; 

3:  dstBmap  =  GMGetBitmap  () ; 

4:  GMCopy2  (皿 odulelD,  srcBmap ,  dstBmap , 

5  :  色 srcB 皿 ap— >rect , 色 gv— >winPtr->graph.rect , 

6 :  pit ,  pit ,  0,  NULL) ; 


最後に ウィン ドウの Bitmap を 戻したり、 パレ ッ トを 破棄す るな どの 
後始末を します。 


[ List  3-30  • 後 処理 

1: MMPtrDispose  ((Pointer)  GMExgBitmap  (txtBmap) ) ; 
2:  CLD isposePalet  (pit) ; 

3 :  GMUnlockBits  (img); 


描画の 手順は やや 複雑です が、 ほ とん どの 場合に 同様の 手順を 踏む、 
いわば、 定型 パターンです。 一度 理解して しまえば、 応用は 難しくない 
でしよう。 

t 画な のな 縮 

画像の 圧縮は、 伸張の 場合と 逆の 手順を 踏みます。 画像の 描かれた Bits 
を VMCompress 関数に 渡し、 圧縮され た 画像 ファイルを 得ます。 圧縮の 
際、 どの 画像 形式で 圧縮す るかを 指定す る 必要が あります。 これには 伸 
張の 説 目 月で も 出て きた モジュール の を 用います。 

圧縮 形式を 明示的に 指定す るか わ りに、 システムの デフォルト の 圧縮 
形式を 指を する こと もで き ます。 デフォルトの 圧縮 形式は IVM.X を 2 回 
の 起動す ると 現れる ダイア ロ グで 設定 します。 

次に、 画像の 圧縮の 具体的な 手順を 示します。 
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画像の 描かれて いる Bits は 伸張の 場合と 同様、 G.GRP タイプで なけ 
れ ばな り ません。 圧縮され た データを 格納す る ハン ドルを 指定す る こと 
もで きます。 一般に 圧縮され た あとの データ サイズは 不定な ので、 どの 
程度の 大きさの ハン ドルを 確保す るか 瞄む ところで すが、 ハン ドルの 大 
きさが 不十分な 場合、 自動的に 拡張され るので、 適当に 数 バイトの 大き 
さの ものを 確保して おけば よいでしょう。 また、 ハンドル じ NULL を 指 
定 すると 自動的に ハン ドルが 確保され ます。 


[List  3-31 • 画 佚の 圧 偏 

1: Bits**  img;  /* 画像の 描かれて いる Bits  */ 

2:  Handle  hdl; /* 圧縮され た 画像 データを 格納す る ハンドル*/ 
3:  hdl = VMCompress  (img,  NULL, -1, NULL,  NULL,  0) ; 


この 例では モジュール ID として一 1 を 指定し、 デフォルトの 圧縮 形 巧 
で 画像を 圧縮して います。 画像の 圧縮に 失敗す ると、 VMCompress 関数 
の 返り 値は NULL になり ます。 

# 静止画 像の 伸張/圧縮の サンプル プロ グラム 

静止画 像の 伸張を 扱った サンプル プログラム VMSMPL1.X を 紹介し ます。 
VMSMPL1 . X はビ デオ マネージャ が 対応 している 形式の 画像 ファイルを 
伸張し、 グラフィック ウインドウ じ 表示し ます。 


Fig.  3-7  •  VMSMPL1.X  の 画面 


VMSMPL1.X は ビデオ マネー ジャと グラフィック ウィン ドウを 利用す る 
ので、 あらかじめ ビデオ マネージャと GRW.X を 起動して おきます。 

VMSMPL1.X を 起動す ると ウィ ン ドウが 關 くので、 ビデオ マネー ジャで 
対応して いる 形式の 画像 ファイルを ドラッグし、 ウィン ドウに ドロップし 
ます。 VMSMPLl.X は ドロップ された 画像 ファイルを 伸張し、 グラフ ィッ 
クウ イン ドウ 中に 65 が 6 色で 表示 します。 
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7) アニメー シヨ ンポ ート 
の 詳細は、 残を ながら、 
公開され ていません。 


8) フロッピー ディスク 等 
の 遅い デバイス を 使う 
と コマ 落ちが; がしくな 
り ます。 また、 RAM デ 
ィス クを 使う とフ アイ 
ルモー ド じする 意 巧が 
ありません。 


静止画 像の 圧縮 じついて は、 この あとの 「CGA 作成の サンプル プ ログ 
ラム」 （P.109) で 取り上げて いますので、 そちらを 参照して ください。 


アニメ ー  ショ ン 動画 (CGA) の サポートは、 SX- WINDOW  ver.3.0 の 目 
玉 機能の 1 つです。 きちんと 時間 管理を している ので、 たとえば 1 分の 
CGA は、 どの X680x0 シリーズ でも 1 分で 再生され ます。 また、 音声の 
同期 も サポート さ れて います。 

CGA の 再生 や 作成 も、 静止画 像と 同様、 ビデオ マネージャ によって 管 
理 されて おり、 SX コールを 通して 簡単に 斤う ことができます。 

0CGA の 再生 

CGA を 扱う には、 まず、 アニメーション ポートを オープン します。 

アニメーション ポートとは、 複数 枚の 画像 データ、 再生 順序、 音声 卜 
ラック、 トラック 同期 タイ ミンス 画像 メディア タイプ （メモリ 上 じある 
か、 ファイル 上に あるか） といった CGA 再生に 必要な 一連の データ 群を 
ま とめた ものです7)。 

アニメ ー シヨ ン ポート には メモリ モー ドと ファ イ ル モー ドの 2 つの 動 
作 モードが あります。 メモリ モードを 指定す ると、 管理情報 や 画像 デ ー 
夕を 含めた CGA 全体が メモリ 上に 置かれます。 そのため、 再生 や 作成が 
高速に 行えます が、 ずべ てを メモリ 上に 置く 必要が あるた め、 空き メモ 
リ iU 上の 大きさの CGA を 扱う ことができ ません。 

一方、 ファイル モードを 指定す ると、 管理情報 のみを メモリ 上に 置き、 
画像 データは ファイル 上に 置きます。 そのため、 空き メモリの 大きさの I 
上の 巨大な CGA も 扱う ことができ ますが、 再生の 速度は ファイルを 格納 
している デバイスに 依存し ます8)。 

それでは まず、 CGA の 再生の 手順を 説明し ます。 

既存の CGA ファイルを ファイル モー ドで 再生し ます。 最初に CGA ファ 
イル （SAMPLE. CGA) を オープン します。 


7) アニメー シヨ ンポ ート 
の 詳細は、 残を ながら、 
公開され ていません。 


8) フロッピー ディスク 等 
の 遅い デバイス を 使う 
と コマ 落ちが; がしくな 
り ます。 また、 RAM デ 
ィス クを 使う とフ アイ 
ルモー ド じする 意 巧が 
ありません。 


List  3-32  •  CGA ファイルの 才 ープン 
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2:  fh  =  TSOpen  ("SAMPLE. CGA" ,  0) ; 


次に、 アニメ ー シヨ ン ポー トを ファイル モー ドで 作成し ます。 CGA ファ 
イ ルの ファイル ハン ドルを 引数 じして VMCreateF 関数を 呼び出します。 
アニメ ーショ ン ポー トの 作成に 失敗す ると NULL が 返り ます。 


[List  3-33  • アニメーシヨ ンポー トの 作成 

1 : Handle  aport ; 

2  :  aport  =  VMCreateF  (fh) ; 

3 :  if  (aport  ==  NULL) 

4:  { 

5:  TSErrDialogN  (D.CONFIRM, 

6:  "アニメー シヨ ンポ ートの 作成に 失敗し ました。"）； 

7:  } 


表示に 備えて、 アニメーションの 縦横の サイズを 調べます。 VMGetWidth 
Height 関数を 呼び出す と、 アニメ ー ショ ンの サイズを 表す ポ イン トが 
返り ます。 


List  3-34  • アニメー シヨ ン サイズを 朗 ベる 

1:  Point  asize; 

2 :  asize  =  VMGetWidthHeight  〇; 


必要な 情報を 取り出したら、 次に アニメーション ポートを クローズし 
ます。 CGA を 再生 するとき には 必ず アニメ ーショ ン ポー トを クローズし 
なければ なりません。 


[ Ust  3-35  • アニメー シヨ ンポー トの クロー ズ 

1 : VMCiLose  (aport) ; 


次に、 CGA を 表示す るた めの 準備を します。 CGA の 表示は グラフ ィッ 
クウ ィン ドウを 使用し ます。 グラフィック ウィン ドウを 開く 手順は 「グ 
ラフィック ウィンドウ」 （P.92) の 項を 参照して ください。 ここでは、 すで 
に グラフ ィッ クウ ィン ドウが 開いて いる ものと します。 CGA 表示の 準備 
は、 静止画 像の 場合と まったく 同じです。 詳細は 「画像の 表示」 （P.101) 
の 項を 参照して く ださい。 
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[ List  3-36  •  CGA の 表示の 单備 

1: GMAPage  (15) ; 

2:  GMForeColor  (G—THRU) ; 

3：  GMPenMode  (G.PSET) ; 

4  :  GMFillRect  (&gv->WiiiPtr->graph.  rect) ; 
5 :  txtBmap  =  GMMakeGrpBitmap  () ; 

6：  palt  =  CLRefer  (PALT_G655%) ; 

7 :  old  =  GMSetPalet  (palt) ; 


CGA の 再生 を 開始し ます。 再生には VMPlay 関数を 呼び出します。 


[ List  3-37  •  CGA  の 再生 

1: rect  =  gv- >WinPtr- >graph.rect ; 
2:  GMMoveRect  (&rect ,  (LPoint)  0) ; 
3  :  VMPlay  (gv->AnimHdl , ferect) ; 


最後に 後始末を します。 


[ List  3-38  • 後 処理 

1: MMPtrDispose  ( (Pointer)  GMExgBitmap  (txtBmap) ) ; 

2:  GMSetPalet  (old) ; 

3  :  CLDisposePalet  (palt) ; 


じ I 上で CGA の 再生が 始まり ます。 これの^ 降は イ ベン ト に応じて 化理を 
斤い ます。 実際には アニメ ー シヨ ン ポー トと イベント レコードを 引数に 
VMEvent 関数を 呼び 化せば、 あとは ビデオ マネー ジャが 適切な 化 理を行 
います。 


[yst  3-39  •  VMEvent 巧 数の 呼び出し 

1: VMEvent  (aport ,  feeventrec) ; 


CGA の 再生を 終了す る ときは アニメーション ポート を 破棄し、 CGA ファ 
イ ルを ク ローズし ます。 


[ List  3-40  •  CGA ファイルの クロー ズ 

1 : VMDispose  (aport) ; 
2:  TSClose  (fh) ; 
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CGA の 再生は、 再生を 始める までが 少し 複雑です が、 一度 再を を 始め 
てし まえば あとは VMEvent 関数に ほとんど 任せる ことができ ます。 


0  CGA のか 成 


9)CPLK.X  (DDZ  氏 作製) 

という フリー ソフトを 
イま 用す ると、 CGA ファ 
イ ルに ADPCM データ 
を 追加す る ことができ 
ます。 添付 CD- ROM の 
¥DEVEL0P デイ レクト 
リ じ 収録され ています。 


最後に CGA の 作成に 挑戦して みま しょう。 

静止画 傑の ところで も 述べた ように、 CGA は 複数 枚の 静止画 像 か ら構 
成されて います。 つまり、 1 枚 1 枚の 静止画 像を 順次 登録して いくこと で 
CGA が できあが ります。 なお、 画像の I 外の メディア （ FM 音源 や ADPCM 
など） の 登録 方法 •は、 残念ながら、 わかって いません。 ビデオ マネージャ 
(IVM.X) には 画像に I 外の メディ アを 登録す る 機能がない ので、 なんとも 
しよう が あり ません 9)。 

CGA の 作成 手顺を 説明し ます。 

まず、 新しく 作成す る CGA の ファイル 名を 決定し、 その 名前で ファ イ 
ルを オープン します。 オープン した ファイルの ファイル ハン ドルを 引数 
に VMCreateF 闡 数を 呼び 化し、 アニメ ー シヨ ン ポート を ファイル モー 
ドで 作成し ます。 


[ List  3-41 •  CGA フ アイ ルの 作成 

1 : int  fh; 

2  :  Handle  aport ; 

3：  fh  =  TSCreate  ("NEW. CGA",  2); 
4:  aport  =  VMCreateF  (aport) ; 


10) 「画像の 伸張」 の 項 
(P.98) を 参照。 


次に メディア を 登録 します。 メディア には 画像 や 音声な どが ありま すが、 
現在、 ビデオ マネージャでは 画像の [外の メディ アは サポート されて いない 
ので、 メディア ニ 画像 となります。 メディア の 登録は VMRegi  St  Sample 
阀 数で 斤い ます。 

登録す る 画像 データは、 メモリ 上の ハン ドルに 格納され ている 必要が 
あります。 そのため、 ファイル 上の 画像 データは 一度 メモリ 上に 読み込 
む 必要が あります 10)。 また、 1 つの アニメー ション ポート 内では、 すべ 
ての 画像は 同一の 形式で なければ なり ません。 


[Ust  3-42  • 画な データの 登録 

1: Handle  img;  /* 画像の 格納され ている ハンドル*/ 

2  :  id  =  VMRegistSample  (im 区， MMHdlSizeGet  (img) , -1 ,  0) ; 
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メディアの 登録に 成功す ると、 メディア ID が 返ります。 メディア ID 
は 1 枚 1 枚の 函像 じつ けられた 通し番号で、 の J 蜂、 この メディアので 各 
画像を 参照し ます。 

画像 データの 登録が 終わったら、 次に タイム スケールの 設定を します。 
タイム スケールとは、 CGA 再生に おいて 再生 時間 を 指定す る 際の 単位を 
決定す る パラメータです。 タイム スケールが ぶの 場合、 時間の 単位は 差 
秒に な ります。 タイム スケールの 設定は VMSetTimeScale 関数で 斤い 
ます。 


VMSetTimeScale  (64) ; 

この場合、 時間の 単位は 莫秒 じなります。 タイム スケールは、 この 
あとの モーションの 登録に 閱 係して きます。 

次に モーションを 登録し ます。 モーションとは、 登録され た 画像の 再 
生 順序 およ び 表示 期 問を 指 します。 モー ショ ンの 登録は VMInsertFrame 
関数で 斤い ます。 VMInsertFrame 関数では、 メディア ID で 示される 画 
像を、 どの位 置に （何番目に)、 どれ だけの 時間表 示す るかを 指定し ます。 
表示す る 時間の 単位は 先 ほど 設定した タイム スケールで 決まり ます。 

VMInsertFrame  (id, -1 ,  4); 

この 例では、 id で 示される 画像を 一番 最後 （一1) にネ弔 入して います。 夕 
イム スケールが 64 だとす ると、 単位 時間は^ 秒です から、 この 画像を 
知 秒 間、 つまり 義秒間 表示す る ことになります。 なお、 1 つの 画像を 何 
回 指定しても かまいません。 

次に CGA の 総 再生 時間 長を 設定 します。 総 再を 時間は VMSetDuration 
関数で 設定し ます。 単位は タイム スケールを 基準に します。 次の例では、 
全部で 10 枚の 画像を それぞれ 表示 時間 4 で 表示す るた め、 総 表示 時間を 
40 に 設定して います。 

VMSetDuration  (4  *  10) ; 

最後に CGA を ファイルに 出力し ます。 VMClose 関数を 呼び 化して ア 
ニ メー ショ ン ポート を クローズ すると、 自動的に CGA の 内容が ファイル 
に 化 力され ます。 忘れずに ファイルを クローズす るよう にして く ださい。 
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[Ust  3-43  •  CGA ファイルの クロー ズ 

1: VMClose  (aport) ; 

2:  TSClose  (fh) ; 


0CGA 再生の サンプル 

ここでは、 CGA 再生を 扱った サンプル プログラム VMSMPL2.X を 紹介 
します。 

VMSMPL2.X は 非常に シンプルな CGA 再生 プログラムです。 拡張 子が 
" .CGA" の ファイルを 読み込み、 グラフィック ウイン ドウ 上で 再生し ます。 


Fig.  3-8  •  VMSMPL2.X  の 画面 


VMSMPL2.X は ビデオ マネージャと グラフィック ウィン ドウを 利用す る 
ので、 あらかじめ ビデオ マネージャと GRW.X を 起動して おきます。 

VMSMPL2.X を 起動す る と ウィンドウが 關く ので、 拡張 子が ".CGA" の 
CGA ファイルを ドラッグし、 ウイン ドウに ドロ ップ します。 VMSMPL2.X 
は ドロップ された CGA ファイルの 再生を グラフィック ウィン ドウ 上で 始 
めます。 ウィン ドウ 上で 右 ボタンを クリ ック すると ポップアップ メニュー 
が 現れ、 ポップアップ メニューからは ウィン ドウの サイズを 元に 戻した 
り、 CGA ファイルを メモリ に 読み込んで 高速に 再生した りする ことが で 
きます。 

t  CGA か 成の サンプル プログラム 

CGA 作成を 扱った サンプル プログラム VMSMPL3.X を 紹介し ます。 
VMSMPL3.X は、 非常に 簡単な CGA 作成の プログラム 例です。 CGA 作 
成の 手順を 示す ことが 主 目的な ので、 これ 自体には ほとんど 応用 性は あ 
りません。 もっと 実用的な もの （スクリプトを 解釈す る もの や、 インタ ラ 
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ク ティブに CGA を 編集す る ものな ど） を 作る 際の 参考に してく ださい。 

VMSMPL3.X と、 添付 FD じ 含まれる 招: 張子が ".RPC" の 画像 フ ァイ 
ルを 同じ ディレクトリ に 置いた のち、 VMSMPL3.X を 起動して く ださい。 
ウィンドウは 開かず、 ダイアログ のみ 表示され ます。 無事 CGA が 作成 さ 
れ ると、 同じ デイ レクト リに SAMPLE.  CGA という ファイルが できあがつ 
ている はずです。 


Fig.  3-9  •  VMSMPL3.X で 作成した CGA の 再生 画面 


できあがった CGA ファイルは、 先の VMSMPL2.X や、 CG ビジ ヨン .X を 
使って 再生して みて ください。 

じ [上、 SX-WINDOW  ver.3.0 の^ 降で 拡張 さ れた 機能のう ち、 グラ フィ ッ 
ク 画面に 関する ものに ついて、 その 基本的な 利用の 手順を 駆け足で 説明 
してき ま した。 

筆者の 技量 不足と 紙幅の 都合から 細部 ま で 十分に 説明す る こと がで き 
なかった 箇所が 多々 あるかと 思います。 そういう 部分に 関しては、 添付 
FD に 収録され ている サンプル プログラムの ソース リスト を 参照す るよ 
うにして く ださい。 
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1) 追 補 版の 付録 デ イス 
ク じ 収録 さ れ ている 
SXDEF.H  と  SXLIB.H 
のこと を 指す。 


calino  header は Workroom と 互換性の あ る イン ライ ンへッ ダです。 
calino  header を 利用 すれば、 今まで ライブラリを リンクし ていた プ 
ロ グラムの 大半を コ ン パイ ルし なおす だけで、 高速 かつ コ ン パク ト な 実 
斤フ ァイ ルを 作成す る ことができます。 

また、 旧版の ヘッダり と 互換性が あるので、 過去の プログラムを 蘇ら 
せる ことが 可能です。 


インス ル） 


calino  header は、 Table  3-5 に 示す ファイルから 構成され ています。 


Table  3-5  •  calino  header をな 成す る ヘッダ ファイル 


へツ ダフ アイ ル 名 

内  容 

Animat 1 on_i .h 

アニメー シヨ ン マン 

じ 010 r_i .h 

カラー マン 

Contro し 1 .h 

コント ロ ー ルマン 

Dia 丄 og_i .h 

ダイ ア ログ マン 

Event_i .h 

イ ベン ト マン 

Except ion_i .h 

エ クセプ シヨ ン マン 

Font_i .h 

フォン ト マン 

Graph-i .h 

グラフマン 

Key_i .h 

キー マン 

Keyboard.!  .h 

キ ー ボ ー ド マン 

MText.i .h 

テキス ト マン （マルチ フォント） 

Me 皿 ory_i .h 

メモリ マン 

Menu_i.h 

メニュー マン 

Mouse_i.li 

マウス マン 

Prin ■し i .h 

プリント マン 

Resource.! .h 

リ ソース マン 

Semaphore 丄  h 

セ マフ ォ マン 

Subwindow_i .h 

サブ ウイン ドウ マン 

Task_i .h 

タスク マン 

Text_i .h 

テキス ト マン 

Video.i.h 

ビデオ マン 

Window_i .h 

ウイン ドウ マン 

sxdecl .h 

互換性を 保つ ための 各種 マクロ 定義 

111 


Chapter  3  SX-WINDOW  ver  3.1 開発 キット 


へツ ダフ アイ ル 名 

内  容 

sxcall . equ 
inc  丄  ude .  an 

sxlib.h 

X680x0  gcc 用の インク ルー ド ファイル 
Workroom へ‘ シ ダに がす る ハ。 ッチ 
化1 版との 互換性を 保つ ための ヘッダ 

callno  header が 提供す るのは 関数 宣言の みです。 構造体 定義な ど 
は いっさい 行わない ので、 Workroom のへ ッ ダ （あるいは 旧版の ヘッダ) 
が 必要と なり ます。 

イ ンス トールを 行う 前には、 念のため、 自分の include ディレクトリ 
の バックアップを とって おいた ほうがよ いでしょう。 

g  Workroom 巧 境 に X31KIT) の 場合 

ここでは 環境 変数 include に 設定され ている ディ レクト リ に Work¬ 
room  のへ ッ ダ ファイル （SXDEF2.H,  SXGRAPH.H など） がすで じイ ンス 
卜ー ルされ ている ものと します 似 下、 環境 変数 include に 設定 さ れて 
いる ヘッダ ファ イ ルの 存 をす る ディ レクト リ を 《include とする)。 

まず、 《include じ SX という 名前の サブ デイ レクトり を 作成 します。 


>  cd  $ include 

>  mkdir  sx 


この サブ デイ レクト リに callno  header のす ベての ヘッダ ファイル 
(*-i.h) を コピーし ます。 

さ ゎ に、 $include  へ  callno  header  の  sxcall . equ  をコ ヒーし 
ます。 すでに 同名の ファイルが 存在し、 これを 消したくない 場合には、 
callno  header の sxcall.equ を 別の 名前に 変更し、 環境 変数 SXEQU 
に その フルパス 名を 指定して く ださい。 

最後に、 Workroom の ヘッダに パッチを 当てます。 これは、 状況に 応 
じて Workroom の ヘッダが callno  header を 読み込む よう に 設定す る 
ためです。 $include に 千ホ厲 の include  .  dif を コピーし、 $  include 
ディレクトリで patch. X を 実行 します。 


>  cd  $ include 

>  patch. X  —pi  <  1 凸 c 丄 ude.dif 

V _ y 

じ [上で、 Workroom 環境 (SX31KIT) で 使用す る 場合の イ ン スト ー ルは 
終了です。 
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• 旧版 ヘッダ (SXDEF.H) 斌 寅の 場合 

ここでは、 $  include じ 旧版 ヘッダが すでに イ ンス トー ルされ ている 
ものと します。 

まず、 《include に SX という 名前の サブ ディ レクト リ を 作成 します。 


>  cd  $include 

>  mkdir  sx 


この サブ デイ レクト リ じ calino  header のす ベての ヘッグ' ファイル 
(*_i.h) を コピーし ます。 また、 旧版 ヘッダの SXLIB.H もコピ ー （ ない 
しは 移動） します。 

さ ら に、 $include に calino  header の sxlib.h をコ ピーし ます。 
取 後 じ、 $include  に  calino  header  の  sxcall.equ  をコ ピーし 
ます。 すでに 同名の ファイルが 存在し、 これを 消したくない 場合には、 
calino  header の sxcall.equ を 別の 名前に 変更し、 環境 変数 SXEQU 
に その フルパス 名を 指定して く ださい。 

り Jl で、 旧版 ヘッダ （SXDEF.H) 環境で 使用す る 場合の インス トー ルは 
終了です。 

# 両方の 環境を 併用す る 場合 

calino  header は Workroom 環境 と 旧版 ヘッダ 環境と で 同時に 使用 
する ことができます。 この場合は、 それぞれの 環境に 応じた インスト ー 
ルを 斤って く ださい。 

( 利用 方法^ 


t コンパイル 方法 

calino  header の 利用は、 いたって 簡単です。 SXCALL 関数を イン ラ 
イン 展開したい 場合に、 マクロ  -_SX_INLINE__ を 定義して コンパイル 
する だけです。 

a) ライブラリを リ ンク する 場合 
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>  gcc  — SX  - 0  sample . c  -Isx 


J 


b) イ ン ライン 展開を する 場合 

gcc  -SX  -0  sample .  c  -Isx  -D __ SX_INLINE __ 


2) 第 2 部の SX コールリ 
フ アレンスを 参照して 
く ださい。 


b) のように イン ライ ン 展開 指定を 行って コ ン パイ ルした 場合には、 ほ 
とん どの SX コール 呼び出しが インライン 展關 されます。 この場合、 ‘-Is ぉ 
として ライブラリを リ ンク する 必要が ないよう に 思われ ますが、 実際には 
スタート アップを リンクす るた めじ 必要です。 また、 CLEvent など、 一 
部の 関数は SX コールで はなく ライブ ラ リで すので、 このような 関数2) に 
ついても ライブ ラ リをリ ンク する 必要が あり ます。 


® ライブラリとの 互換性 


ライブ ラ リの 一部 （リ ソー スマ ン闕 係） では ライブ ラ リ 変数 errno じ 
値を 返して くる ことがあります 力ぶ、 callno  header では それを 考慮し 
ていません。 リ ソース マン 脚 係の 関数を 呼んだ あとで errno を 参照して 
いるよう な プログラムは、 callno  header を 利用して コンパイル すると 
誤動作す る 可能性が あり ます。 そのよう な 場合は、 callno  header で 
はなく、 ライブラリを 用いる 必要が ある ことに 注意して ください。 


callno  header  の义点 


3) エラー メ ツセー ジ 中の 
行を 号を 見て、 その 斤 
を 参照す る 手法は 「夕 
グ ジャンプ」 と 呼ばれ 
ています。 


callno  header を 利用して コンパイル すると、 ほとんどの SXCALL 
関数の 名前が プリプロセッサの 段階で _sx_???? の 形式に 変わり ます。 
そのため、 コンパイラの エラー や 警告に おいても _sx_???? としか 表示 
されず、 どの 関数に 対する エラー や瞥告 なのかが わからな く なって しま 
います。 

対策と しては、 コール 番号と 関数 名の 対応を 覚えて おく、 エラー や警 
告の 発生した ソース リス ト 中の 行 番号を 頼りに するな どが 考えられます。 
し 力  >  し、 前者は すべての M 数 じついて 覚える のは 不可能で すし、 その 都 
度 確認す るの も 面倒です。 筆者の 場合は、 後者の、 斤 番号を 利用して ソー 
スを 参照し、 どの 闕 数で エラーが 発生した のかを 調べる 手法を とってい 
ます 3)。 
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callno  header  の 仕様 


>  予約語  SXCALL  と -SXCALLPtr 


4) 開発 言語で、 あら かじ 
め 役割が 決められ てい 
る 文字列。 C 言語での 
if や for と いった 文字 
列の ようじ、 機能が ホ 
まって おり、 変数 名と 
しては 使用で きない 文 


X680x0  gcc の SX モー ドでは、 予約語4) SXCALL と _SXCALLPtr を 用 
いる ことで ライブラリ を 経由せ ずに SX-WINDOW の システム コールを 
直接 呼び出す こと がで きます。 

さて、 この 機能は どのように 実装され ている ので しょ うか。 

実際に この 機能を 実現 するとい う 観点から 考えて みると、 ク リアす ベ 


字 列の こと。 


き 点が 3 つ 挙げられます。 


(1)  どのように A-line  trap を 発 斤す るか。 また、 その 番号を どの 
よう に 指定す るか。 

(2)  ワード サイズ や バイ ト サイズの 引数を どうやって スタックに 積む か。 

(3)  A0 レ ジ スタ に 返り 値が あ る コールを どう 扱う か。 


じ I 下、 具体例を 挙げながら、 ひとつひとつ 見て いきましょう。 


1. A-line  trap  の 発行 

まず はじめに、 用語の 整理を して おきます。 

la 下では、 SX-WINDOW の シス テムコー ルを 「SX コール」、 予約語 
SXCALL を 用いて 宣言され た 関数を 「SXCALL 関数」 と 呼んで それぞれを 
区別し ます。 

さて、 どうやって A-line  trap を 発行す るかです が、 ここでは 説 巧を 
簡単に する ため、 引数 も 返り 値 も 持たない SXCALL 関数を 考えます に ist 
3-44)。 


[List  3-44  • 引数、 返り 値の ない SXCALL 巧 数 

1 : SXCALL  void  foo  (void)  ;  く—— SXCALL  関数の 宣言 

2 :  void  bar  (void) 

3:  { 

4:  foo  ();  < SXCALL 関数の 呼び出し 


SXCALL 関数は 単なる 宣言であって、 通常の 関数の よう に その実 体を 
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記述す る ことは できません。 当然、 ポインタで 扱う こと もで きません。 
コ ン パイルして 得られる アセンブラ ソース 上での SXCALL 関数の 呼び出 
し 部々 は、 ちょうど インライン 展開され たよう じなります。 


[ List  3-45  •  List3-44 の アセンブラ ソース 

1： *  N0_APP 

2:  RUNS_HUMAN_VERSION  equ  2 
3  :  . cpu  68000 

4:  .  include  sxcall.eau  < - シンボルを 記述して ある 

5 :  *  X68  GCC  Develop 

6 :  . even 

7 :  .text 

8 :  . even 

9  :  . giobl  -bar 

10:  -bar : 

11:  link  a6,#0 

12:  SXCALL  foo  < - SXCALL  の 呼び出し 

13  :  unlk  a6 

14:  rts 

15 :  . even 

16 :  . end 


"SXCALL  foo" が、 SXCALL の 呼び出し 部分で、 闕 数名が アセンブラ 
の シンボル 扱いに なって います。 "SXCALL” は アセンブラの マクロで、 

SXCALL  皿 aero  callname 

.过 c . w  callname 

endm 


5) これは デフォルトの フ 
アイ ル 名です。 别のフ 
アイ ル 名に 変更す る 場 
合は、 環境 変数 SXEQU 
で 指定 します。 


と sxcall . equ で 定義 されて います。 

あとは この シンボルに A-line  trap の 値を 定義 すれば 完成です。 実 
際に それを 斤って いるの が sxcall  .equ5) なのです。 

つまり、 「C 言語の ソース 上では なく、 それとは 別に アセンブラの イン 
クルー ド ファイル 上で 記述す る 必要が ある」 わけです。 SX コールの 名前 
と コール 番号との が応は 基本的に 不変です から、 一度 sxcall. equ に 記 
述 してし まえば 十分です。 


6) 型が char や short て. 
あっても。 


2 •引数の サイズ 

SXCALL では 引数を スタックに 積みます。 この 引数は、 ワード サイズの 
場合と ロング ワード サイズの 場合の 2 通りが あります。 しかし、 通常 C 
言語の 関数に がする 引数6) はすべ て ロング ワー ドで 穗 まれて います。 
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ライブラリ では、 引数を スタックに 積みな おす ことで この 問題に 対 化 
してい ますが、 これは 実 斤 時に かなりの オーバーヘッド となります。 そ 
こで、 SXCALL 関数では 関数の プロ ト タイプ 宣言を 最大限に 利用す る こ 
とで 対 化して います。 

簡単な 例を 挙げて、 その 違いを 見て みましょう （List  3-46)。 


List  3-46  •引な の ある SXCALL 曲! 数 

void  norma し func  <,int ,  short); 
SXCALL  void  sxca 丄 l_func  i.int ,  short); 

void  foo  (void) 

{ 

nor 虹 a 丄 -func  (1,  2); 
sxcal し func  (1,  2); 


List  3-47  •  List3-46 の アセンブラ ソース 


*  NO— APP 

RUNS— HUMAN-VERSION  equ 
. cpu  68000 
. include  sxcall .equ 

*  X68  GCC  Develop 

. even 
.text 
. 台  ven 

.globl  _foo 
_f  00  : 

link  a6,#0 
pea  2.W 
pea  l.w 

jbsr  _normal_func 
move . w  #2, (sp) 
pea  l.w 

SXCALL  sxcall-func 

1111 Ik  a6 

rts 


< —— 型が short でも ロング ワード 

< --- 通常の 関数 呼び出し 
< - 型 力く  short なので ヮード 

< --- SXCALL の 呼び出し 


7)  SXCALL 関数の ほうは、 
アセンブラ ソース 上で 
も 関数 名の 前に "(ア 
ン ダー バ ー） がつ いてい 
ない ことじ ま 意して く 
ださし、。 これは、 自 みで 
sxcall . equ を吕も ぶす 
る 際に 重要です。 


. even 
. end 


norma し func は 通常の 関数、 sxcal し； func は SXCALL 関数です'）。 通 
常の 関数の 呼び出しでは、 2 番目の 引数が プロトタイプ 宣言で 「short」 
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と 宣言して あっても、 実際には ロング ワー ドで スタックに 積まれて しま 
います。 

他方、 SXC  ALL 関数では、. プロトタイプ 宣言のと おりに ワードで 積ま 
れ ています。 つまり、 新たに SXCALL 関数を 宣言す る 場合、 利用したい 
SX コールの 引数の サイズ じを 意し、 ワー ドで 積むべき 引数に 対しては 正 
しく 「short」 あるいは 「unsigned  short j と 指定す る 必要が ありま 
す。 ここで、 


バイ ト サイズの 引数は どうす るの か 


の バイ ト サイズで スタ ッ 
クじ 巧んだ 場合 
(move . b  do,- (sp) 
など)、 スタックは I  ノく 
イ ト よけいに 消 資され、 
スタックは 偶数 バウ ン 
ダリ じ 保持され ます。 


という 問題に 気つ' きます。 MC 6800 0 では バイ ト サイズで スタックに 積む 
ことができない8) ので、 SXCALL 宣言で 引数の 型を 「char」 にしても う 
まく いきません。 なかには 引数と して バイ ト サイズを 要求す る SX コー 
ル も 存在し ます 力 《、バイ ト サイズの 引数は 必ず 2 つ 続いて おり、 1 つに ま 
とめて ワー ド サイズの 引数と 見なす ことで 対 化する ことが 可能です。 あ 
るいは、' ワード サイズの 引数の 上位 バイ トと 下位 バイ トに それぞれ 別の 
意味が 割り当てられて いると 考える ほうが 自然 かも しれません。 


3.  A0 レジスタへの 返り 値 

SX コー ルでは、 返り 値の 受け渡し じ DO と A0 の 2 つの レジスタを 使 
用し ます。 しかし、 通常 C 言語の 関数の 返り 値は 1 つです し、 ア セン ブ 
ラ ソース 上では DO レジスタ のみを 返り 値の 受け渡しに 使用す るので、 そ 
のままでは A0 レジスタの 値を 参照す る ことができ ません。 

そこで、 X680x0  gcc では、 A0 レジスタへの 返り 値を 参照す るた めに、 
_SXCALLPtr という 名前の 変数が 予約され ています。 これは、 「プ ログ ラ 
ムの 任意の 位置での A0 レジスタの 値を 保持す る のり^* 型の 変数」 とし 
て 実装され ており、 SXCALL 関数を 呼び出した 直後に 参照す る ことで AO 
レジスタ の 値を 利用す る こと がで きます。 

この _SXCALLPtr は 「任意の 位置」 で 参照 可能です が、 SXCALL 関数 
を 呼び出さずに 参照したり、 不必要に 参照を 猩ら せたり した 場合には、 
その 値に 意味がない、 出カ コー ドの 最適化に 悪影響を 与える といった 結 
果を 引き起こします のでを 意して く ださい。 

U 上で、 SXCALL 関数の 仕組みが ほぼ 理解で きた こと と 思います。 

この 機能を 利用した sxcall.h および sxcall.equ は、 すでに 『〔マ 
ガ ジン J  (ソフトバンク 刊） の 付録 フロッピー ディスク や、 パソコン通信 
などで 配布され ています ので、 それらを 入手 すれば 備 単に SXCALL 関数 
を 利用で きます。 


118 


3-3  calino  header 


すでに 便利な ヘッダが 存在し、 かつ 配布され ている にもかかわらず、 新 
たに "calino  header" を 作成 した 背景には 次の よう な 理由が あリ ます。 
これらは 裘を 返せば SXCALL 関数の 機能が 不十分な 点で も あり ます。 

(1)  アセンブラの 引数の 並びと C 言語 関数の 引数の 並びと が 必ずしも 
同 じでは ない。 

(2)  ライブ ラ リ 内部で SX コール 呼び出し じ [外の 化理を 斤って いるもの 
が ある。 

(3)  -SXCALLPtr を 直す 妾 ソース 中に 記述す るのは、 特定の 環境に 依 巧し 
すぎる。 


これら 3 つは 相互に 非常に 密接な 関係に あり ます。 そこで CMFind 関 
数を 例に とり、 まとめて 説明し ます。 


$A299  CMFind 


引数 

long  pt  ; ポイント （口一 カ ル 座標） 

long  winPtr  ; ウインドウ レコー ドへの ポインタ 

返り 値 

DO.L  =0  該当する コント ロー ルは ない 
か  パ ー トコ _ ド （下位 ヮ ー ド） 

/ リ ザル トコード 

A0.L  コント ロール レコー ドへの ハン ドル 
C の 関数 

int  CMFind (  LPoint  pt,  Window  本 winPtr, 

Control  ***ctrlHdl) ; 

CMFind 関数は DO レジスタに パー トコ ー ド、 AO レジスタ じ コント ロー 
ルレ コー ドの ハン ドルを 返して きます。 どちらの 返り 値 も 必要な ものな 
ので、 C 言語の プロトタイプ 宣言では、 3 番目の 新たな 引数と して A0 レ 
ジ スタの 値を 代入す るた めの ハン ドルへの ポイ ンタが 追加され ています。 
この 3 番目の 引数は、 アセンブラでの 引数の 並びには あり ません。 

この CMFind 阀 数を SXCALL 閱 数と して 宣言す る 場合、 どのよう にす 
れば よいので しょうか。 

SXCALL  int  CMFind  (LPoint ,  Window*) ; 

アセンブラに あわせる とこの よう になり ます。 

しかし、 Workroom では 引数が 3 つ ある ものが 正しく、 これでは プロ 
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ト タイ プ 宣言と 実際の 呼び 化しと で 引数の 並びが 違っ てし まい、 エラー 
となります。 もちろん、 ソースの ほうを 引数が 2 つの 形に し、 さらに 
.SXCALLPtr を 参照す るよう に 書き換えれば よいので す 力ぶ、 すると 今度 
は Workroom でコ ン パイ ルで きな く なって しまいます。 

SXCALL  int  CMFind  (LPoint ,  Window* ,  Control***); 


上の 例では Workroom にあわせて 引数を 3 つに しています。 3 番目の 引 
数は 無® C になります が、 これで 問題な く コンパイル する ことができます。 

しかし、 できあがった 実 斤 ファイルは 正しく 動作し ません。 その 理お 
は、 3 番目の 引数 じがして 適切な 嫂理を 斤って いたのは 純正 ライブラリ 
であって、 SX コー ルではなかった という ことです。 

SXCALL 関数の 実体は、 単に SX コールを 呼び出す だけです から、 これ 
では 3 番目の 引数に 対して 何の 化理も 行われず、 プログラムを 正しく 動 
作させる ためには、 結局、 プログラム 中に -SXCALLPtr の 参照を 書き足 
さなければ なり ません。 

このよう じ SXCALL 関数の 機能は 非常に 強力な のです が、 一部の SX 
コールに がして は ちょっと 力不足です。 そこで、 間に ワン クッション 置 
く ようにして みます。 


[list  3-48  • ワン クッション* いた SXCALL 巧 おの 記述 

SXCALL  int  sxcal し CMFind  (LPoint ,  Window*) ; 

static  inline 

int  CMFind  (LPoint  a,  Window*  b,  Control***  c) 
{ 

int_stat  =  sxc all -CMFind  (a,  b) ; 

*(c)  =  (Contro：L**)  .SXCALLPtr; 
return  stat ; 

} 

int  foo  (LPoint  a,  Window 幸  b,  Control 幸 幸*  c) 

■C 

return  CMFind  (a,  b,  c) ; 


このよう に アセンブラ レベルの SXCALL 関数を 別名で 宣言し、 C 言語 
レベルの 関数を イ ン ライ ン闡 数と して 記述し ます。 イ ン ライン 関数の な 
かでは、 まず、 SXCALL 闕 数を 呼び出 し、 さら に 従来は ライ ブ ラリ カぶ 斤っ 
ていた 3 番目の 引数に 闕 する 化理を 斤い ます。 この イ ン ライ ン 関数を 利 
用した 場合、 呼び 化し 部分の アセンブラ ソースは 次の よう になり ます。 
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List  3-49  •  List3-48 の アセンブラ ソース 


♦  NO-APP 

RUNS_HUMAN_VERSION  equ 
. cpu  68000 
. include  sxcall . equ 

♦  X68  GCC  Develop 

. even 
. text 


. even 

. globl  _f 00 

I : 

link  a6,#0 
move . 1 12(a6) ，- (sp) 
move . 1 8(a6) ，- (sp) 
SXCALL  sxcal し CMFind 
move . 1 16(a6) ,al 
move . 1  aO, (al) 
unlk  a6 
rts 


. 色 ve 凸 
. 色 打 d 


2 


<— SXCALL 呼び出し 
< ---  3 番目の 引数の 処理 


これで、 必要 十分な 化理が 効率よ く 斤 われて いる ことが わかり ます。 
へッ ダ 内で このような イ ン ライ ン 関数 化を する ことで、 Workroom の 
仕様に そつ て 書かれた ソースを 変更し なくても コ ン パイ ルが 可能 となり、 
かつ SXCALL 闕 数の 機能を 十分に 利用した 実行 ファイルを 作成す る こと 
がで きる ようになります。 

実際 じは calino  header では、 次の ような 命名 規則を とっています。 


[ List  3-50  •  calino  header での SXCALL 閒数の 命令 規貝リ 

a)  ワン クッション 必要な 場合 

SXCALL  int  _sx_a299  (LPoint ,  Window*); 
static  inline 

int  CMFind  (LPoint  a,  Window 幸  b.  Control 幸 幸*  c) 

{ 

int-stat  =  sxca 丄丄 -CMFind  (a,  b) ; 

♦(c)  =  (Control**)  _SXCALLPtr; 
return  stat ; 

} 

b)  化 要ない 場合 

SXCALL  int  _sx_a29e  (Wi 丘 dow 幸, Regio 丘 幸 幸)； 

拌过 efine  CMDraws  _sx_a29e 
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9) これが  callno  head 
er の 名前の 由来です。 


SXCALL 関数の 名前を _sx.callno の 形式9) で 定義し、 C 言語 レベル 
の 関数の 名前を イ ン ライ ン 関数 あるいは マクロ 名と して 定義し ます。 既 
存の SXCALL 関数の 定義を 変更したり、 新たに SXCALL 関数を 追加す る 
場合に も、 この 命名 規則に 従う ようじし てく ださい。 


Workroom へツ タとの 関係 


callno  header は、 Workroom の ヘッダに パッチを 当て、 マクロ 名 
__SX_INLINE__ が 定義され ていた 場合、 この パッチ 部 かから サブ デイ レ 
ク トリ 下の インラインへ ッ ダ ファイルを 読み込みます。 

じ [下に、 パッ チ 後の Workroom の 各へ ッ ダで callno  header を 呼び 
出す 部分を 示します。 

#if  (defined  __SX_INLINE__  &&  defined  __GNUC__) 

#include  <sx/?????_i .h>  < - ヘッダ ごとに 適切な インライン 

拌 include  <sx/?????_i .h>  < - ヘッダを 読み込む 

#else 

#ifdef  __PR0T0_TYPE 
ANSI プ ロト タイプ 宣言 
#endif  /*— PR0T0_TYPE  */ 

KR 形式の 宣言 
#endif 


各へ ッ ダから 読み込まれる イ ン ラインへ ッ ダの 対応 表を la 下に 示し ま 
す (Table  3-6)。 

化 ble  3-6  •  Wor い oom ヘッダと それに 対応す る インライン ヘッダ 


Workroom ヘッダ 

イン ライ ン ヘッダ 

COLOR. H 

Color_i .h 

CONSOLE. H 

Ani 皿 atio 丘- i .h 
Exception-i .h 
Key_i .h 
Keyboard,! .h 
Mouse 丄  h 

CONTROL. H 

Control-i .h 

DIALOG. H 

Dialog_i.li 

EVENT. H 

Event _i .h 

MENU.H 

Menu_i .h 

PRINT. H 

Print-i .h 
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Workroom へッタ 

イン ライ ン ヘッダ 

RESOURCE .H 

Resource_i .h 

SXGRAPH.H 

Font.i .h 

Graph_i .h 

Se 皿 aphore_i .h 

SXMEMORY.H 

Memory.i .h 

TASK.H 

Task-i .h 

TEXT.H 

MTest.i .h 

Text_i .h 

VIDEO. H 

Video 丄  h 

WINDOW. H 

Subwindow 丄  h 

Window.i .h 

Workroom ヘッダと 旧版 ヘッダとの 併用 


callno  header では、 Workroom ヘッダ および 旧版の ヘッダ'  (SXDEF 
•  H， SXLIB.H) の 両方の 環境で 利用す る ことが 可能です。 これは 型 や 構造 
体の 名前に 対する マクロ 名を 用意し、 使用す る ヘッダに よって、 その 値 
を 変える ことで' 実現して います。 

これらの マクロ 名の 化理は sx/sxdecl.h で 集中 して 斤 われて おり、 
Workroom か 旧版 かの 判定は、 マクロ 名 __SXDEF2_H  (Workroom の SXDEF 
2 .  H で 定義 される） が 定義 されて いれば Workroom 環境、 そうでな けれ 
ば 旧版 環境と みなして います。 


各 マクロ 名と、 実際の 型 や 構造体の 名前と の 対応を の^ 下に 示 します 

(Table  3-7)。 


Table  3-7  • マクロ 名と 実 晓の型 •構造が るとの 巧応 


マクロ 名 

Wor い 00 m 環境 

旧版 ヘッダ 環境 

__B00L 

BOOLEAN 

i 打 t_ 

一 POINTER 

Pointer 

pointer 

..HANDLE 

Handle 

handle 

一 HEAP 

Heap 

Heap 

一 BLOCK 

Block 

Block 

—MASTER 

Master 

Master 

—MOUSE 

Mouse 

MsRec 

__MSCSR 

MsCsr 

TXCsr 

一 EVENT 

Event 

event 

— LPOINT 

LPoint 

point_t 

__RECT 

Rect 

rect 

—REGION 

Region 

region 

Bitimg 

unsigned  short 
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マクロ 名 

Workroom  環境 

旧版 ヘッダ 環境 

—LASCII 

LASCII 

LASCII* 

一 GSCRIPT 

GScript 

gScript 

一 Blimp 

Bitmap 

bitmap 

— GRA  則 

Graph 

graph 

..POLYGON 

Polygon 

polygon 

__NP0LY 

NPoly 

void 

一 NPOLYENV 

NPolyEnv 

void 

__RECTIMG 

Rectimg 

rectimg 

—BITS 

Bits 

bits 

—WINDOW 

Window 

window 

—SUBWIN 

Subwin 

subWindow 

__MENU 

Menu 

menu 

—CONTROL 

Control 

control 

..DIALOG 

Dialog 

dialog 

—DILIST 

DIList 

dlglList 

._T  邸  IT 

咒 dit 

tEdit 

— T 邸  IS 

TEHis 

teHis 

— TECOLUMN 

TEColumn 

teColumn 

__TSEVENT 

Ts Event 

tsevent 

—TASK 

Task 

task 

—DRAG 

Drag 

dr  a 良 

—SCRAP 

Scrap 

scrap 

__0PENFILE 

□pent  lie 

openf ile 

—ICSTATE 

IcState 

icstate 

—PRINT 

Print 

prRec 

__PDRVRINFO 

PDrvrInf o 

prtdinf o 

__FQNTLIST 

FontList 

FontList 

—KEY 

Key 

KmRec 

— KBOARD 

KBoard 

KbRec 

__TX16 

TX16 

txl6 

__GS0NEENV 

GSOneEnv 

void 

—PEN 

Pen 

void 

__SPLTBZ 

SpltBz 

void 

__SPLTBSP 

SpltBSp 

void 

__MTEDIT 

MTEdit 

void 

__咒301ム？ 

TEScrap 

void 

— TESTYLE 

咒 Style 

void 

―咒  LSTYLE 

咒 LStyle 

void 

—TE  日  PTION 

TEOption 

void 

__ERRPAT 

ErrPat 

void 

—ERRBTN 

ErrBtn 

void 

—PROLOG 

PrDlog 

void 

— PALET 

Palet 

void 

__CRGB 

CRGB 

void 

—PICKUP 

PickUp 

void 

— VLIST 

VList 

void 

__RGBSCAN 

RGBS can 

void 

__CPDFINFO 

Cpdf 王 nf 0 

void 

— GSINFO 

Gsinf o 

void 
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マクロ 名 

Wor い 00 m 環境 

旧版 ヘッダ 環境 

—DPATTERN 

DP at tern 

void 

__VINF0 

Videoinfo 

void 

— VSINFO 

VideoSampleInf o 

void 

__CINF0 

CInf  0 

void 

— CODFINFO 

CODFInfo 

void 

__T 邸 AGE 

TEPage 

void 

—HWINDOW 

HWindow 

void 

— DEV  沈  T 

DevSet 

void 

まとめ 


従 ホ ま での XC と 純正 ライブラリ による SX-WINDOW アプリ ケー ショ 
ンの プログラミングは、 ライブラリの 不具合 もさる ことながら、 速度を 
要ボ すべき 嫂理 において も コール 呼び出しに ワン テンポ 置かなければ な 
ら ず、 足 棚を つけられた 無理の ある プロ グラミ ング スタイルであった と 
いえます。 

その後 登場した、 良 CC の SX モードに よる プログラミングは、 ライブ 
ラリの 不自 もさを 多少な リ とも 吸収して くれた ものの、 やはり、 速度 面 
や 新しい コ ー ルへの 対応の 手軽 さ とい っ た 面では 改善され たと はいいが 
たい ものが ありま した。 

それにが して、 calino  header の 利用に よる SXCALL 闕 数の イ ン ライ 
ン化 という 新しい 手法に よる プロ グラミ ング では、 従来の ライブラリ を 経 
由す るコ ー ル 形式と 比べて 案 斤 ファ イ ルの 速度は かなり 向上し ヘッダを 
書き足す だけで 新しい コ ー ルへの 対応 も 簡単に 斤え るな ど、 SX- WINDOW 
プロ グラミ ングの 柔軟 さ、 生産性に おいて 飛驢 的な 進歩を とげた とい っ 
て も 過言では ない と 自負して います。 

すでに SX- WINDOW プロ グラミ ングを 斤って いる 方に も、 これから 始 
めよう という 方に も calino  header は 大き な 肋 力 となる でしょう。 み 
なさん も calino  header を 上手に 利用して 轄 快に 動作す る アプリ ケー 
シヨ ンの 作成を 目指して ください。 
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LIBSXC 


LIBSXC  パッケージは、 Human68k 
上の フ リー ライブラリ である LIBC 
をべ ー ス じ、 SX— WINDOW 対応の 
ための 追加、 なをを 巧った ものです。 
完全に 上位: 互換性を 保って いるた め、 
が 来の LIBC と 置き換えて 利用す る 
ことが' できます。 gcc を 用いて SX— 
WINDOW の アプリ ケーン ョ ン關 発を 
負 指す 人には 必携と いえます。 


Chapter  4  LIBSXC 


1) 完全 フ リーの 〔ライ 
ブ ラリ。 NIFTY-Serve な 
どの 大手 商用 BBS や、 
Network-SX  NG  な どの 
草の根 BBS で 入手 可能 
です。 


2)  1995 年 5 月 現在、 最新 
版の LIBC です。 


本書で 用意した LIBSXC ライブラリ パッ ケージ は、 Human68k 上の フ 
リー ライブラリ である LIBC 1) を もとに、 SX- WINDOW 用の アプリ ケー 
ション を 開発す るた めに 一部 修正を 斤った ものです。 そのため、 LIBSXC 
は LIBC にがして 上位互換性を 保って おり、 従来の LIBC と 蘆き 換えて 
利用す る ことが 可能です。 

なお、 LIBSXC は gcc の SX-WINDOW 拡 •張 機能を 利用 している ため、 
XC  (コ ンパ イラ） での 使用は 不可能です。 必ず gcc を 使用して く ださい。 

また、 本書の 添イ寸 FD に 含まれて いる LIBSXC ライブラリ パッケージ 
は、 LIBC 1 •し 322) をら とに 作成され ています。 LIBC が バージョン アッ 
プ するとと もに LIBSXC も 更新され ていく 予定です が、 その 過程で 本書 
の 記述と 食い違う 部分が 化て くる 可能性が あります。 その 場合は、 最新 
版の LIBSXC に 含まれる ドキュメント を 参照す るよ うにして く ださい。 

本節では、 本書の 添が FD で 提供す る LIBSXC ライ ブ ラリ パッケージ 
の 特徴と 構成 じついて 述べます。 


LIBSXC  〇 特徴） 


LIBSXC の 特徴と してり I 下の 点が 挙げられます。 

〇 リエント ラントな プログラムを 作成で きる 

LIBSXC を 使用す ると、 手轄に リエント ラントな プログラムを 作成 
する こ とがで きます。 通常の LIBC や XC の ライブラリ を 使用 した 
場合、 ライブラリ 内部の 変数は プログラムを 共有す る タスクを 通 
じて 共通 じなります。 これでは、 タスクが 知らない うちに 別の 夕 
スク がその 変数の 値を 書き 檢 えてし まう 可能性が あり ます。 これ 
を 防ぐ には、 大域 変数を 構造体に まとめる など、 プログラマ がよ 
けいな 手間 を かけなければ なりませんでした。 

LIBSXC では、 基本的に すべての ライブ ラ リ 内部 変数を タスク ごと 
に 独立して 持つ よう にして いますので、 手軽に リエン ト ラントな 
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プログラムを 実現す る こと がで きます。 


4-1  LIBSXC  とは？ 


3)TS 邸 en  や  TSCreate 
など。 ファイル 操作は 
主に タスク マンを 通し 
て 行います。 


〇クリ ーナや アイコ ン 表示に 対応 

SX-WINDOW には、 クリ ーナや アイコ ン 表示と いった Human68k 
にはなかった 機能が あります。 そのため、 ファイルの 作成 や オー 
プン といった ファイル 操作を 斤う 場合、 SX コー ル3) を 使用し ない 
と、 フ ァイ ル 操作が 巧 われた という イベント が 通知 さ れ ず、 不具合 
が 発生す る 可能性が あり ます。 LIBSXC では、 これらの ファイル 操 
作 尊 用の SX コールを 使用して います。 

〇 複数の ヒープ 領域を 扱う ことが 可能 

LIBSXC では、 malloc 等の ヒープ 化理闕 数を SX-WINDOW 用に 
変更して あります。 SX-WINDOW は マルチ タスクで すので、 同時 
に 複数の タスクが 動作して います。 しかし、 メモリ 空間は 1 つし か 
ない ので、 複数の タスクが その 中で ひしめき あう ことじな リ ます。 
LIBC や XC の ライブラリ では、 ヒープ 領域は あらかじめ ライブ ラ 
リが 設定した ア ドレスから 移動せ ず、 必要に応じて メモリの 上位 
の 方向に 拡大して いきます。 このような ヒープの 拡大 方法 だと、 メ 
モリ が 余って いるの にもかかわらず、 ヒープ 領域を 拡大で きない 
状況が 発生し ます。 LIBSXC は、 この 問題を 回避す るた めに、 複数 
の ヒープ 領域を 管理す るよう に 変更して います （詳しくは 次 ページ 
の コラム 「SX-WINDOW の メモリ 管理と malloc」 を 参照して く 
ださい)。 LIBSXC は、 メモリ 空閒 をより 有効に 使う ことができる 
わけです。 


LIBSXC ライブラリの 構成) 


本 普で 用意した LIBSXC ライブ ラ リパッ ケージ は、 LIBC にタ ホして 上 
位 互換性を がって います。 ここでは LIBSXC のへ ッ ダと ライブラリ の 内 
をに ついて 備 単に 紹介しながら、 どのよう にして 上位 互換を 実現して い 
るかに ついて 説明し ます。 
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©コラ 厶： SX-WINDOW の メモリ 管理と malloc 


SX-WINDOW は マルチ タスク です の 
で、 同時に 複数の タスクが 動作して いま 
す。 しかし、 メモリ 空 I 削は 1 つし かない 
ので、 Fig.  4-1 のように、 複数の タスク 
がその 中で ひしめき あう ことにな り ます。 

ここで、 malloc  I 划 数を 使う ことを 考 
えてみ ます。 LIBC や XC の ライブラリ 
の 皿 alloc 閒 数は、 ヒープ 領域から メ 
モリを 怖 H 呆 します。 

ヒープ 領域とは、 プログラムが ス ター 
卜  するとき  に  malloc 等の ために あら か 
じめ 確保され る メモリの ことです。 ヒー 
プ 領域 は ある 程废 余が を もって 確保され 
ますが、 当然、 足りなくなる こと も あり 
ます。 その 場合、 奠 斤を I 川 祈す るか、 ヒー 
プ 領域を お大 します。 

LIBC や XC の ライブラリでは、 ヒー 
プ 領域は あらかじめ ライブラリ が 設定し 
た アドレスから 移動せ ず、 必嬰 じ 応じて 
メモリ の 上位の 方向 にお 乂 していき ます。 
Human68k のよう じ シングル タスクの 
OS の 場合は これで 十分で したが、 SX- 
WINDOW  のよう に マルチ タスクで 動作 
する 場合には 問 避が 化 じます。 

たとえば、 Fig.  4-2 のよう な 状況では、 
タスク 1 や タスク 3 は ヒープ 領域を 抱 •火 
していく ことができます 力ぶ、 タスク 2 は 
すぐ あとじ タスク 3 力ぶ いるた め、 まだ ほ 
かの 部分に メモリ がを っ ている のに も か 
かわらず、 これ U 上、 ヒープ 領域を 拡大- 
する ことができません。 

そこで LIBSXC では、 分 断され たお 
数の ヒープ 領域を 管理で きる ようにし ま 


した。 Fig.  4-2 のよう ながが で、 タスク 
2 の ヒープ 領域を 拋 •大 する 場合、 Fig.  4-1 
のように メモ リの 余って いる 箇所に もう 
1 つの ヒ ープ 領域を 備保 します。 つまり、 
タスク 2 は ヒープ 領域を 2 つ 持つ ことに 
なります。 


Fig.  4-1 •  LIBSXC  の 場合 
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参 LIBSXC の ヘッダ 

LIBSXC ライブ ラ リ パッケージに 含まれて いる ヘッダと 内容は LIBC と 
まったく 同 じです。 ただし、 $include/svs ディレクトリ にある 次の 3 


4-1  LIBSXC  とは？ 


つの ファイルは、 LIBSXC と LIBC とで ヘッダを 共有す るた めに 追加 あ 
るいは 修正が 加えられて います。 


Table  4-1 •  LIBSXC と LIBC で 異なる ヘッダ ファイル 


ヘッダ 

内  容 

xstart .h 

LIBC との 互換性を 保つ ために あり、 gcc の 動作 モー ドに 応 
じて 下の 2 つのう ち、 いずれ かを 読み込む。 

xstartJm.h 

Human68k 用の LIBC と して 動作す る 場合に 読み 这 まれる。 

xstart_sx.h 

SX- WINDOW 用の LIBSXC と して 動作す る 場合に 読み込ま 
れ る。 

4)"gcc  -SX" で 指を しま 
す。 


5) 必ず 2 つ 同時にを 義さ 
れ るので、 どちら か 一 
方を チェック すれば 十 
みです。 


これらは ライブラリの 内部 動作に 深く 関係した ヘッダで、 通常、 ユー 
ザが 直接 参照す る 必要は あリ ません。 また、 参照した 場合には、 ANSIC 
の 規格から 外れる ことじな り ます。 

LIBSXC と LIBC とで ヘッダを 共有す るた めに、 gcc が 自動で 定義す 
る マクロ 名を 利用して います。 gcc で SX モー ドを 指定す る4) と、 マク 
口 名 SX_GCC および〜 SX_GCC— が 自動的に 定義され ます。 この 2 つの 
マクロ 名 5) は、 「今、 コンパイラは SX モードで 動作して いる」 という こ 
とを 示して います。 ヘッダ 内では、 #ifdef で これらの マクロ 名を チェ ッ 
ク し、 自動的に LIBSXC と LIBC とを 切り替えて います。 


鎌 LIBSXC の ライブラリ 

LIBSXC ライブ ラ リノ、。 ッ ケージには、 14 個の ライブラリ ファイルが あ 
ります。 そのうち libsxc.a(l) は LIBSXC 専用、 libc.a(l) は LIBC 
専用です が、 それ iU 外の 12 個の ライブラリ ファイルは LIBSXC と LIBC 
とで 共用され ます。 

gcc は、 動作 モード じよって libc  •  a(l) と libsxc.a(l) のど ちら 
を リンクす るかを 自動的に 決定し、 リン々 じ 指示を 出します。 通常の 動 
作モー ドでは、 libc.a(l) を リンクす るよう じ 指示を 出します。 一方、 
SX モードでは、 かわりに libsxc.a(l) を リンクす るよう に 指示を 出し 
ます。 このよう に 動作 モー ドに あった ライブ ラ リが 自動的に 選択され る 
ので、 通常の 使用では 特に 気にする 必要は あり ません。 

次に、 LIBSXC と LIBC とで 共用され る 12 個の ライブラリ ファイルに 
ついて 説明し ます。 なお、 これらの ライブラリ ファイルの なかには SX 
モー ドでは 使用で きない （リ ンク して も 正常に 動作し ない） ものが あり 
ます。 

それぞれの ライブラリ ファイル について 少 し 詳しく 見て みま しょう。 
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6)gcc は、 SX モー ドで 
は プロファイラ 使用の 
オプションが 無視され 
ます。 


〇 そのまま 利用 可能な もの 

libcplus  :  C++ で 使用 される ライブラリ 
libgnu  : 四 則 演算な どの 基本的な ライブラリ 
libmb  : マルチ バイ ト 文字 用の ライブラリ 
libw  : ワイド 文字 用の ライブラリ 

これらは LIBSXC でも 問題な く 利用 可能です。 

〇 利用 可能 だが、 制限 もしくは 副作用が ある もの 

libsuper  : スーパ バイ ザ モー ドで 実 斤す る 場合に 必要な ライブ 
ラリ 

libtz  : タイム ゾーン 関係の ライブラリ 

これらは LIBSXC でも 明示的に リンクす る こ とで 利用す る こ とが 
可能です。 ただし、 動作 上の 制限 や 副作用が あります。 詳細は、 こ 
の あとの 「4.2  LIBSXC プログラミング」 （P.134) で 説明し ます。 

〇 関数の 一部が 使用 不可能な もの 

libdos  :  DOS コール 用の ライブラリ 
libiocs  :  IOCS コール 用の ライブラリ 
libscsi  :  SCSI コール 用の ライブラリ 

これらは LIBSXC でも 明示的に リ ンク する ことで 利用 可能です。 
ただし、 SX-WINDOW 上では 使用 しては いけない 関数を 含んで 
いるので、 使用す る 場合は 注意が 必要です。 詳細は、 この あとの 
「4.2  LIBSXC プロ グラ ミン グ」 （P.134) で 説明し ます。 

〇 現時点では 使用 不可能な もの 

libprof  : プロファイラ （計測） 用の ライ ブラ、) 
libsignal : シグ ナル 関係の ライブラリ 

これらは SX-WINDOW のこと を まったく 考慮して いないので、 使 
用す る ことができません。 プロファイラは あると 便利な ので、 将 
米 的には これに 対応、 したいと 考えて います6)。 

〇 使用 不可能な もの 

libbas  :  X-BASIC 関係の ライ ブラり 

X-BASIC は SX-WINDOW に 対応して いないので、 libbas を 使 
用す る ことは でき ません。 
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これら 12 個の ライブラリ を 利用す る 場合、 gCC に対して 明示的に リン 
クを 指示し なければ なりません。 ただし、 libgnu だけは 必ず リンク さ 
れ るので、 明示 ft 勺に 指示す る 必要はありません。 たとえば、 libdos と 


4-1  LIBSXC  とは？ 


libmb を リンク したい 場合、 gcc に対して 次の よう に コマン ドラ イン か 
ら 指示し ます。 

( gcc  -SX  foo.c  -Idos  -Imb  i 

‘‘-1’’ は 「ライブラリを リンク しろ」 という オプ ショ ン で、 その あと 
に リンク したい ライブラリの 名前を 続けて 書きます。 ライブ ラ リの 名前 
には、 "libdos.a" や "libmb .a" から 先頭の "lib" と拡- 張子を 除いた、 
"dos"， "mb" とい っ た 文字列 を 指定 します。 
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ここでは LIBSXC を 使った 実際の プロ グラミ ング について 説明し ます。 

LIBSXC は LIBC を もと じ 作成 さ れ ており、 LIBC とまった く 同 じ 感覚 
で プロ グラムを 作成す る こと がで きます。 むしろ gcc の SX が: 張 機能の 
おかげで、 XC を 使用 したと きのよう じ 大域 変数を 構造体に ま とめたり す 
る 手間が なく、 すっきり とした プログラム になります。 

そこで、 まず 基本的な LIBSXC の 使用法を 習得す るた めじ、 第 3 章 
「SX-WINDOWS  ver.3.1 I 網 発 キット」 （p.73) で 紹介した サ ン プル プロ グ 
ラムを LIBSXC 用に 修正して みます。 実際に プログラムを 修正して みる 
ことで、 LIBSXC への 移 斤が 非常に 簡単な ものである こと を 感じ とって 
ください。 

次に、 よく 遭遇す る トラブルに ついて、 その 原因と 対 化 法を 説明し ま 
す。 ここで 取り上げる トラブルは、 パソコン通信を 通じて ユーザから 寄 
せられる 質問の なかで も 特に 多い ものです。 

そ して 最後に LIBSXC 独自の プロ グラミ ング テクニック について ふれ 
ます。 これらの テクニックは 中級 じ I 上の SX-WINDOW プログラマの 必 
修 事項と いえる でしよう。 


( 基本的な LIBSXC プログラミング) 


まず 基本的な LIBSXC の 使用法を 習得す るた めに、 「CGA 再生の サン プ 
ル」 （P.109) で 紹介した サンプル プログラム VMSMPL2.C を、 LIBSXC 用 
に 修正して みま しょう。 

0 とりあえず 動かす 

きっちりと LIBSXC 用に 修正す る 前に、 「とリ あえず 動く」 ようじ 最低 
限の 修正を してみ ま しょう。 修正す るのは たった 1 行です。 

VMSMPL2.C の 56 行 目から 始まる、 「カーネルの 設定」 という 箇所の、 
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List  4-1 •  VMSMPL2.C  62 行 目 （修正 前) 


62:  char  .sxkernelcomm [] =  "sxkernel .x" ; 


という 行の先頭に" common" を 付け足します。 


[List  4-2  •  VMSMPL2.C  62 巧 目 （修正を） 


62:  common  char  _sxkernelcommu  =  "sxkernel .x" ; 


と り あえず 動かす ための 修正は これ だけです。 実に 衞 単な ものです。 
本当に 動く かどう か コンパイルして 実行して みま しょう。 

I  A: >  gcc  -SX  —日  vmsmpl2 . c  — Isxc  — lsx3  — Isx  i 

きちんと 動き ま した か？  Workroom に 付属 している サン プル プ ログ ラ 
ム も、 すべて こ の 修正で LIBSXC 用に （とりあえず） 変更す る こと がで、 き 
ます。 

ところで、 サンプル プログラム VMSMPL2.C をよ く 見る と、 先 ほどの 
「カーネルの 設定」 という 部分は 次の よう になって います。 


[ Ust  4-3  •  VMSMPL2.C  56 行 目が あ 

56 :  /* 

57:  ♦ カーネルの 設定 

58:  ♦/ 

59;  #ifdef  __SX_GCC__ 

60:  common  char  _sxkernelcommLJ=  "sxkernel . x" ; 
61 : #else 

62:  char  _sxkernelcomm[] =  "sxkernel .x" ; 

63 :  #endif 


1) 「LIBSXC の ヘッダ」 
(P.I30) を 参照。 


これは マク ロ 名 __SX_GCC__ 1) を テス ト する こ とで、 SX モー ドのと き 
と、 そうでな いとき とじ 場合 分けして います。 このよう じ 記述す る こと 
で、 XC と gcc  +  LIBSXC のど ちらで もコ ン パイルで きる ようになり ま 
す。 本書の 添 化 FD に 収録され ている サンプルは、 SXCSMPL.C を 除いて 
すべて このように LIBSXC でも コ ン パイルで き るよう になって います。 


0 きちんと 修正す る 

さて、 化 ほどの 修正で とりあえず 動く ようには なりました。 しかし、 
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2) ここでい う 「素直」 と 
は、 「ごく 普通に」 くら 
いの 意昧 です。 


3)  変数の 名前空間 をみ 離 
させる ことができ るの 
で、 まとめる こと 自体 
は 非常 じよい アイ ディ 
ア です。 

4) " 居 EventMask" と 書く 
のと 大差ない といえば 
そうな のです が…。 


これ だけでは 本当に 「ただ 動く」 だけで、 gCC  +  LIBSXC を 使う 意味が 
半減して しまいます。 

gcc  +  LIBSXC を 使う 大きな 利点の 1 つは、 大域 変数を 素直2) に 記述 
できる ことじあります。 XC を 使った 場合、 Workroom の サンプル プ ログ 
ラム や 本書の 第 3 章 「SX-WINDOWS  ver.3.1 開発 キット」 (p.73) の サン 
プル プログラムの ように、 大域 変数を 構造体で ひとまとめ にし、 さらに 
大域 変数に アクセス する 関数 すべてに 大域 変数への ポイ ンタを 引数と し 
て 渡す 必要が あ りました に ist  4-4)。 


List  4-4  •大巧 ま! 数を まとめた 構造体と 閱数 プロトタイプ  1 

1 

/* 

/* 

2 

* タスク 毎に 確保す る 変数の 構造体 

* プロトタイプ 

3 

♦/ 

*/ 

4 

tvpedei  struct  { 

int  CheckGRW  (glVal*) ; 

5 

int  EventMask; 

int  init  (glVal*) ; 

6 

TsEvent  Event Re c; 

void  tini  (int,  glVal*) ; 

7 

(中略） 

(中略） 

8 

LPoint  AnimSize ; 

void  GetDrag  (glVail 本)； 

9 

10 

int  AnimMode ; 

}  glVal; 

void  Syste 皿 Eve 凸 t  (glVal*) ; 

なぜ、 このような 手閒を かける 必要が あるので しょ うか？ 

XC で 普通に 大域 変数を 使用した 場合、 その 大域 変数は タスク 共通の 
変数に なって しまいます。 つまり、 ただ" TsEvent  EventRec;" とする 
と、 フ°  ロ グラムを 共有す る 他の タスク が この 変数を 書 き 換えて しまう 可 
能 性が 出て きます。 それでは 困る ので、 XC では 大域 変数を 構造体に まと 
め、 実行時に auto 変数と して、 あるいは ヒープ 上に 確保す る ことで 大 
域 変数を タ スク ごと に 分離 しています。 

大域 変数を 構造体に まとめる のは 悪く はない3) のです が、 実際に 大域 
変数に アクセス する 際、 "gv->Even1:Mask" といちい ち 書かなければ な 
り ません4)。 

一番 問題な のは、 大域 変数に アクセス する 閒数 すべて に 大域 変数への 
ポイ ンタを 引数と して 渡さなければ ならない ことです。 関数の 引数は 関 
数を 呼び出す たびに スタックに 積まれる ので、 プログラム 実 斤 時に かな 
りの オーバーヘッド じなります。 

さて、 このよう な手閒 も、 gcc  +  LIBSXC では 無用 となります。 gcc 
の SX モー ドでは 素直に "TsEvent  EventRec;" と 大域 変数を 記述す る 
だ けで タスク ごと にか 離し た 大域 変数 になり、 プログラムを 共有す る 別 
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の タスクが この 変数を 書き換え るよ うな ことはなくなります。 先 ほどの 


大域 変数と 関数 プロ ト タイ プは 次の よう じ 修正 します (List  4-5)。 


[iJst  4-5  •  LIBSXC 用に 修正 後の 大域を 数と 閱数 プロ ト タイプ 


1 

/* 

/* 

2 

* タスク 毎に 確保す るを 数の 構造体 

* プロトタイプ 

3 

♦/ 

本/ 

4 

int  gEventMask ; 

int  CheckGRW  (void) ; 

5 

TsEvent  gEventRec; 

int  init  (void) ; 

6 

Window*  gWinPtr ; 

void  tini  (int) ; 

7 

(中略） 

(中略） 

8 

LPoint  gAnimSize ; 

void  GetDrag  (void) ; 

9 

int  gAnimMode ; 

void  SystemEvent  (void) ; 

大域 変数が 素直に 記述され、 闕 数の 引数に もよ けいな ポインタが あり 
ません。 大域 変数の 名前の 先頭に" g" を 追加して あるのは、 「大域 変数 
である」 ことを 明示す るた めの もので、 特に 化の 変数との 衝突が 起こら 
なければ つける 必要は あり ません。 

次に 個々 の 関数 も 修正 しましょう。 ここ では 例 として KeyDownEvent 
関数を 取り上げます。 


[ List  4-6  • 修正 前の  KeyDownEvent  閣数 


1 :  void 

2  :  KeyDownEvent  (良 IVal 幸 邑 v) 

3:  { 

4:  /* イベントを 取り除く*/ 

5  :  TSGetEvent  (gv->EventMask ,  &gv->EventRec) ; 


List  4-7  • 修正 後の  KeyDownEvent  巧 数 
1 : void 

2 :  KevDownEvent  ^.void) 

3:  { 

4:  /* イベントを 取り除く*/ 

5  :  TSGetEvent  、gEventMask, 色 gEventRec) ; 


斤うべき 修正は 2 つです。 1 つは 閱 数の 引数から 大域 変数への ポ イン 
夕を 削除す る こと、 もう 1 つは 実 隙に 大域 変数を アクセス している 部分 


137 


Chapter  4  LIBSXC 


を 書き換えます。 

KeyDownEvent 闕 数の 場合、 まず、 関数の 引数から 大域 変数への ポ イン 
夕 "glVal*  gv" を 削除し ます。 削除した 結果、 引数が なくなる ときは 引 
数を‘‘ void" じして おきます5)。 次に、 実際に 大域 変数に アクセス している 
部分、 "gv->EventMask",  "gv->EventRec" を それぞれ" gEventMask", 
"gEventRec" と 修正 します。 

他の 関数に ついても 同 じ 手順で 修正 を 加えます。 全部 修正 し 終えたら、 
先 ほどと 同様に コンパイルして 実 斤して みま しょう。 きちんと 動き まし 
たか？ 動かない ときは、 もう 一度 ソースを 確認して みまし ょう。 きっと 
修正し 忘れ や、 修正 間違いが あるは ずです。 それでも 獻 目な ときは、 こ 
の あとの 「4-3 トラブルシューティング」 （P.139) を 参照して みて くだ 
さい。 

まとめ) 


既存の プログラムの 修正を 通して、 LIBSXC での プロ グラミ ングの 実 
際を 紹介して きました。 LIBSXC を 使う のは 全然 難しくな く、 実は 使った 
ほうが プロ グラミ ングが 楽に な るんだ、 という ことを 漠然とで も 感じる 
こ とがで きれば しめた ものです。 

あとは 「習うよ り 慣れろ」 で、 1 つで も 多くの プログラムを 作って、 順 
次 ステップ アップして いってく ださい。 その 過程で わからな いこ とが あっ 
たと き には、 本書の APPENDIX  B 章 「LIBSXC 便利帳」 （p.l 日 9) を 開い 
てみ てく ださい。 
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h ラブ ルシニ 


ここでは LIBSXC を 使用して いて 比較的よ く 遭遇す る 2 つの ト ラブ ル 
について、 その 原因と 対 化 方法を 説明し ます。 ここで 取り上げる ト ラブ 
ルは、 パソコン通信を 通じて ユーザから 寄せられる 質問の なかで も 特に 
多い ものです。 

個 々の トラブルを 説明す る 前に、 いくつか 注意点 を 述べて おきます。 

まず、 ここで 取り上げる 2 つの トラブルは いずれも リ ンクの 段階で 起き 
る ものです。 そのため、 リンカに 闕 する 知識が 必要になります。 また、 具 
体 的に トラブルを 見つける 段階では アセンブラの 知識が 必要に なり ます。 
予備知識な しで も わかる ように 詳しく 説明 はし ま す 力ぶ、 最低限 MC68000 
の アセンブリ 言 語が 理解 できる ことを 前提と します。 

Relative  error 

プログラムが 大きく なって く ると、 管理の 都合 やコ ン パイル 時間の 
短縮の ため、 プログラムを 複数に 分割す る ことがあ ります。 "Relative 
error" は、 このように 複数に 分割され た プログラムを リンクす る 段階 
で 発生し ます。 次の 小さな プログラムを 例に とり、 エラーの 原因と その 
が 化 方法を 見て いきます。 


[ List  4-8  • プログラム  f  〇〇 .  C 


1 : common  int  f 〇〇  = 1; 


[ List  4-9  • ブロ  グラム  bar .  c 

1:  extern  int  10 o; 
2: 

3 :  int  bar  (void) 
4:  { 

5  :  return  foo; 

6:  } 
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l)has がつ ねじ 使用す る 
オプ シヨ ンを 設定し ま 
す。 has は 実行時に 環 
境 変数の 内容を コマン 
ドラ インの 最後に 追加 
します。 


foo.c の ほうでは 変数 f 00 が 初期値 1 と して 定義され ており、 bar.c 
から 変数 foo を 参照して います。 

見れば す ぐに わかる ように、 foo.c では "common  int  foo" となっ 
ている のに、 bar.c では "int  foo" となって いて "common" が ありま 
せん。 これでは 変数の 記憶 クラスが 違うた め、 bar.c からの 変数 foo の 
参照は うまく いきませ/レ。 

この 2 つの プログラム foo.c と bar.c を gcc の SX モー ドで コ ンパ 
イル 、リ ンク してみ ます。 


A: >  gcc  — C  -SX  foo.c  bar.c 
A:>  gcc  — SX  foo.o  bar . o 

X68k  SILK  Hi-Speed  Linker  v2.29  Copyright  1989-93  SALT 
Relative  error  in  bar . o 
at  00000006  (text) 

A : /usr/bin/gcc . x :  Program  Ik. x  exit  status  65535 . 


"Relative  error" はリ ンカ hlk の 化す エラー メ ッ セージで、 相対 
アド レッ シングで 廊 かない ア ドレスを 指定した 場合 や、 ア ドレスを 示す 
属性の シンボルを ワード や バイト の 値と して 書き込もう とすると 発生し 
ます。 "in  bar .0  at  00000006  (text)" というのは、 オブジェクト 
ファイル bar.  0 中の テキス ト セクションの 00000006 番地 （16 進数） で 
エラ ー が 猪 生 した こ とを 示して います。 

さて、 エラーの 雖 生した 場所は わかり ましたが、 その 原因は これ だけ 
では わかり ません。 

そこで、 アセンブラ has の オプション‘- が を 使って リス トフ ァイ ルを 
作成し ます。 リスト ファイルとは アセンブル リストの ことで、 List  4-10, 
List  4-11 のよう じ、 アセンブリ 言語の 命令と それに 対応す る 機械語の コー 
ド （単なる 16 進数） が 対に なった ものです。 この リスト ファイルは 通常 
化 力され ない ので、 必 嬰な 場合には アセンブラ has に対して オプション 
‘-が を 指' 志す る 必要が あり ます。 廠摆 has を 呼ぶ 場合には "has  -P" と 
すれば よいので すが、 今 巧の ように has が gcc から 間 梭的じ 呼び 化さ 
れる 場合、 環境 変数 HAS りを 川いて 問 接 的に 指を します。 


A : >  set  HAS  -p 
A : >  gcc  — c  -SX  foo.c  bar.c 


このよう にして 得られた リス トフ ァイノ レ f  〇〇  .prn,  bar  .prn のうち、 
必要 な 部分の みを la 下に 示します。 
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List  4-10  •  foo.pr 凸： foo.c の リスト ファイル 


5  00000000  *  X68 

6  00000000 

7  00000000 

8  00000000 
9  00000000 

10  00000000  _foo: 

11 00000000  00000001 

12  00000004 

13  00000004 


GCC  Develop 
.globl  _f 00 
. even 
.data 
. even 

•  dc.l 1  < - 変数 f 00 の 実体 

. 色  ven 
.end 


r  List  4-11 •  bar . pr 旦： bar .c の リス トフ アイ ル 


5  00000000 

6  00000000 

7  00000000 

8  00000000 
9  00000000 

10  00000000 
11 00000000  4E 560000 


*  X68  GCC  Develop 
. even 
. text 
. even 

. globl  _bar 


-bar: 


link  a6,#0 


8 

12 

00000004 

202D???? 

皿 ove.l . 

9 

~~~~ 

オフセットは 2 バイ ト みしかない 

10 

13 

00000008 

jbra  ?1 

11 

14 

00000008 

?1: 

12 

15 

00000008 

4E5E 

unlk  ab 

13 

16 

000000 0A 

4E75 

rts 

14 

17 

000000 0C 

. 色  ven 

15 

18 

000000 0C 

. end 

変数 foo の 実体が ある foo.prn の ほう では、 変数 f 〇〇 を 指す ラベル 
_f  〇〇 に 4 バイ トの 値が みえられて います。 し 力  >  し、 bar.prn では ラべ 
ル _foo を 参照して いる 部分に 2 バイ ト 分の 領域し かありません。 その 
ためじ リンク がで きず、 “Relative  error" となります。 

"Relative  error" が 発生す るのは、 多く の 場合、 この 例に あ るよう 
な 記憶 ク ラスの 違いが 原因です。 リス トフ ァイ ルを 見て、 ラベル _f  00 の 
参照が 賊网 だと わかったら、 次は 個々 の ソースファイルから 變数 foo を 
宣言して いる 筒 所を 探し、 記憶 ク ラスが あ っ ている かどう かを 確認して 
ください。 

この 例の 場合、 foo.c を" int  foo  = 1;" とする か、 あるいは bar.  C 
を "extern  common  int  foo;" と して 記憶 クラスを あわせます。 

ここで 1 つどに 藏 して おきます。 リン々 hlk の マニュアルの 「トラブル 
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シュー ティング」 に、 「SX-WINDOW の OBJR 形式の プログラムの 場合 
は、 さらに- fall-remote もつ けて みて 下さい」 という 記述が ありま 
す。 gcc じ -fal い remote を 指定す ると、 通常の 変数の 記憶 クラスが 
remote になります。 

先 ほどの 例を、 記憶 クラスが あって いないが 態で"-; fall-remote" を 
つけて コンパイルして みます。 foo.c の ほうの 結果は 変わり ません。 


List  4-12  •  bar . prn:  -fall-remote をつ けたと きの リス トフ アイ ル 


9 

10 

11 

12 

13 

14 


已 00000000 
6  00000000 

7  00000000 

8  00000000 
9  00000000 

10  00000000 
11 00000000  4E 560000 
12  00000004  41F9???????? 


*  X68  GCC  Develop 
. even 
.text 

. 色 ve 丘 

.globl  _bar 

_bar : 

link  a6,#0 
lea  _foo,a0 

オフ セツ トは 4 バイ ト みある 


13  000000 0A  203 0D800 

14  000000 0E  4E5E 

15  00000010  4E75 

16  00000012 
17  00000012 


move . 1 (a0,a 日. l),d0 
un  丄  k  a6 
rts 
. even 
. end 


こうすると、 ラベル _foo を 参照して いる 部分に 4 バイ トの 領域が あ 
るので、 リンクす る ことができます。 しかし、 リンク できるだけで 記憶 
クラスが あってい ない ことに は 変わり がな く、 でき あがっ た プログラム 
は 正常に 動作し ません。 

"Relative  error" が 発生した か ら といって、 を 易に ‘‘-fall-re 阻 ote" 
をつ けて 安心して はいけ ません。 きちんと エラーの 原因を 調べる ように 
しましょう。 而 倒な ようです が、 それが プログラミング 技術の 向上に も 
つながり ます。 

Over  flow  error 

プログラム 中 で 大きな 大域 変数を 確保 した 場合、 変 数 参照 のた めの 才 
フセッ トが 2 バイト じ 収ま ら なくなり、 リンカで "Over  flow  error" 
が 発生す る こ とが あ ります。 ここで も 次の 小さな プログラムを 例に とっ 
て、 エラーの 原因と そのが 化 方法を 見て いきます。 


4-3  トラブルシューティング 


List  4-13  • プログラム  f  ubar .  c 


1 

2 

3 


6 

7 

8 
9 

10 

11 

12 


char  -bar [68000] ; 
char  _f 00  [68030]; 

char*  壬 00  (void) 

{ 

return  _foo; 

} 

char 本  bar  (void) 
return  _bar; 

} 


この プログラム fubar.c を gcc の SX モー ドで コ ン パイル、 リンク 
してみ ます。 


A: >  gcc  -SX  -C  fubar.c 
A: >  gcc  — SX  lubar.o 

X68k  SILK  Hi-Speed  Linker  v2 . 29  Copyright  1989-93  SALT 
Over  flow  in  fubar.o 
at  00000014  (text) 

A : /usr/bin/gcc . x :  Program  Ik.x  exit  status  65535 . 


"Over  flow" は リン々 hlk の 化す エラー メッセー ジ で、 シンボルの 値 
を 書き込もうと したと きに、 2 バイト も しくは 4 バイ トで 表現で きる 値の 
範囲を 超えた 場合に 発生し ます。" in  fubar.o  at  00000014  (text)" 
というのは、 オブジェクト ファイル fubar.o 中の テキス トセ クシ ョ ンの 
00000014 番地 （16 進数） で エラーが 発生した こ とを 示して います。 
"Relative  error" のとき と 同様、 まず、 リスト ファイルを 調べます。 


A : >  set  HAS  -p 

A: >  gcc  -c  — SX  fubar.c 


I  List  4-14  •  f ubar . prn:  fubar.c  の リス トフ アイ ル 


1：  已 00000000 

2：  6  00000000 

3：  7  00000000 

4:  8  00000000 

5：  9  00000000 

6: 10  00000000 
7: 11 00000000  4E 560000 
8: 12  00000004  41ED???? 


*  X68  GCC  Develop 
. even 
.text 
. even 

. globl  _f 00 

_f  oo : 

link  a6,#0 

lea  — f oo.w(a5) ,a0 
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9 

13 

00000008 

2008 

皿 ove. 丄  a0,d0 

10 

14 

000000 OA 

4E5E 

unlk  a6 

11 

15 

000000 OC 

4E75 

rts 

12 

16 

000000 OE 

. even 

13 

17 

000000 OE 

. globl  _bar 

14 

18 

000000 OE 

_bar : 

15 

19 

000000 OE 

4E 560000 

link  a6,#0 

16 

20 

00000012 

41ED???? 

lea  — bar . w(a5) ,a0 

17 

— 

オフセットは 2 バイ ト みしかない 

18 

21 

00000016 

2008 

皿 ove.l  aOjdO 

19 

22 

00000018 

4E5E 

unlk  a6 

20 

23 

000000 lA 

4E75 

rts 

21 

24 

000000 1C 

. ev 色 n 

22 

25 

000000 1C 

.rbss 

23 

26 

00000000 

. xdef  — f 〇〇 

24 

27 

00000000 

. rcomm  — foo, 68030 

25 

28 

00000000 

.xdef  — bar 

如 

29 

00000000 

.rcomm  — bar, 68000 

27 

30 

00000000 

. even 

28 

31 

00000000 

. end 

fubax .  c では -foo と -bar という 64K バイ トを 超える 変数が 2 つ 確 
保され ています。 そのため、 関数 f  00 での -foo の 参照は うまくい きま 
すが、 次の 閱数 bar での -bar の 参照は _foo が 64K バイト を 超える 火 
きさを もってい るので、 2 バイ トの オフ セッ ト では 足りな く なリ、 うまく 
いきません。 そのため、 リン々 で" Over  flow" が 発生し ます。 

これは "Relative  error" のとき のよう じ 記憶 クラスの 違いが 原因で 
はなく、 純 砕に オフ セッ トが 足りない ことが 原因です。 そのため"- fall- 
remote"  を 使う こ とが 正しい 解決 方法の 1 つと なります。 "ィ al：L-remote 
，’ をつ けて コンパイル しが I; すと、 リス トフ アイ ルは 次の よう になり ます。 


r  List  4-15  •  fubar.prn:  -fall-remote をつ けたと きの リスト ファイル 


10 

11 

12 


5  00000000 

6  00000000 

7  00000000 

8  00000000 
9  00000000 

10  00000000 
11 00000000 

12  00000004 

13  00000006 

14  000000 0C 

15  000000 0E 

16  00000010 


4E 560000 
200D 

D0BC???????? 

4E5E 

4E75 


*  X68  GCC  Develop 

. 色  veil 
. text 
. even 

•g 丄 obi  _f 〇〇 

_f  〇〇 : 

link  a6,#0 
皿 ove . 1  a5,d0 
add.l  #__foo,d0 
unlk  a6 
rts 
. even 
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13 

17 

00000010 

. globl  _bar 

14 

18 

00000010 

_bar : 

15 

19 

00000010 

4E 560000 

link  a6,#0 

16 

20 

00000014 

200D 

皿 ove . 1  a 日， dO 

17 

21 

00000016 

none."? 7777777 

add.l  # — bar ,d0 

18 

— 

オフ セツ トは 4 

バイ ト みある 

19 

22 

000000 1C 

4E 已 E 

unlk  a6 

20 

23 

000000 1E 

4E75 

rts 

21 

24 

00000020 

. even 

22 

25 

00000020 

. rlbss 

23 

26 

00000000 

. xdef  — foo 

24 

27 

00000000 

. rlcomm  〜 foo, 68030 

25 

28 

00000000 

. xdef  — bar 

26 

29 

00000000 

. rlcomm  〜 bar, 68000 

27 

30 

00000000 

. even 

28 

31 

00000000 

. end 

もう 1 つの 解決 方法は、 大きな メモリを 突 斤 時に 動的に 確保す る 方法 


です。 


具体的には malloc 闡 数を 利用し、 次の f  ubar2 .  c のように します。 


[ List  1-16  • プロ  グフム  fubax2.  C 


1 

2 

3 


6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 


char 幸  _bar; 
char*  _f 〇〇 ; 


char*  f 00  (void) 
return  _foo; 

} 

char 本  bar  (void) 

{ 

return  _bar; 


void  init  (void) 

{ 

_bar  =  malloc  (68000) ; 
_foo  =  malloc  (68030) ; 


2) 実際には malloc の 返 
り 値を チェック する' 必 
要 も あり ますが、 ここ 
では 省略し ま した。 


この場合、 脚 数 foo や bar を 呼ぶ 前に 必ず 脚 数 init を 呼んで 変数 
-bar,  _f  〇〇 を 初期化す る 必要が あり ます2)。 
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( まとめ 


ここでは LIBSXC を 使用す る 際、 リンク の 段階で 比較的よ く 遭遇す る 
エラーに ついて 説明 しました。 実際に エラーの 原因を 探り 解決す るには、 
多くの 知識と なにより も 経験を 必要と します。 筆者 もい きなり このよう 
な 知識を 身に つけた わけでは なく、 数多くの 試 斤 錯誤の 末、 トラブル 解 
決に 対する々 ン のよう な ものを 養って きま した。 みなさん も エラ— にめ 
げ ず、 「謎解き」 とで も 思って 原因を 究明す るよう にして ください。 


4-4  UBSXC 独自の プログラミング テクニック 


ここでは 「簡単な SX-WINDOW の プログラムなら 作成で きる」 とい 
う 中級に I 上の プログラマを 対象に、 LIBSXC 独自の プロ グラミ ング テク 
ニック やト ピックに ついて 説明し ます。 


( 日 BJR 型 モジ ュ~ ルの 作成と を 意 点) 


DOBJR 型 モジ ユー ルの 
詳細は、 本書の コラム 
や Workroom の マニ ュ 
アルを 参照して く ピさ 


2)  たとえば、 "int  a;" 
など。 

3)  たとえば、 "common 
int  a ; " など。 


4) ライブ ラ リの 実行を 制 
御す る 特別な 変数。 


LIBSXC を 使用して 実行 ファイルを 作成した 場合、 デフォルトでは 0BJR 
型 モジュール 1) になり ます。 

通常、 プログラムは テキス ト セクションと データ セクションの 2 つか 
ら 構成され ています。 テキスト セク ショ ン じは プログラムの コー ド 部分 
など 実行中に 変化し ない ものが、 デー タ セク ショ ン には 変数な ど 実行中 
に 変化す る ものが 含まれます。 

0BJR 型 モジュールでは、 リエント ラントと いう 名称のと おり、 コー 
ドが 収められ ている テキス トセ クシ ョ ンを 共有し、 タスク ごとに データ 
セクション などを 用意す ると いう 形式で 資源の 有効 利用を 実現して いま 
す。 LIBSXC を 使用した 0BJR 型 モジュール でも、 通常の 変数2) は タスク 
ごとの データ セクション じ 配置され ます。 しかし、 gcc の common 修飾 
子を つけた 変数3) は、 「複数の タスクに 共通な 変数」 として、 通常とは 別 
の データ セク ショ ンじ 配置され ます。 

LIBSXC の ライブラリ 内部 変数4) の 一部は、 この common 修飾子を つ 
けた 変数と して 定義され、 テキスト セク ショ ンを 共有す る タスクの 間で 
共通に なって います。 そのため、 これらの ライブラリ 内部 変数を 操作す 
ると、 テ ネスト セク ショ ンを 共有す る タスク すべてに 影響を みえる こと 
に 注意し なければ なり ません。 

具体的 じは、 次の よう な 制限 や 副作用が あり ます。 


〇 1 つの タスクを （コマンド ライ ン です 旨定 して） スーパ バイ ザ モー ドで 
実 斤し、 別の タスクを ユーザ モー ドで 実行す る ことは でき ません。 
そもそも SX-WINDOW では、 一般の アプリケーションが スーパ 
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バイ ザ モード で 動作す る こと は 基本的 に 禁止して います。 


〇  0BJR 型 モジュールを 複数 起動した 場合、 一度 タスク カぶ 切り替わり、 
次に 制御が 戻って きたと きには、 errno の 内容は 保証され ません。 
errno の 典型的な 使用 手順は、 


[ List  4-17  •  eerorno の 典型的な 使用 手順 

1 : errno  =  0 ; 

么： X  =  sqrt  け）； 

3 :  if  (errno) 

4:  { 

5 :  iprintf  (stderr ,  " sqrt  failed,  errno  =  7,d\n" , 

errno) ; 

6:  X  =  0; 


5)  たとえば、 ファイルの 
才ー プン、 ク □—ズ じ 
は 必ず SX コー ルを 使 
いますが、 読み込みは 
DOS コー ルを 使います。 
見 ためや 操作 方法を 統 
- •する ための 規約です。 

6) SX-WIND0W に関して 
は、 Workroom の マニ ュ 
アルに その 記述が あり 
ます。 


のように errno をク リアして から ライブラリ を 呼び出し、 その 旌 
後で 値を チ 卫ック します。 これは ANSI で 規定され た 用法で、 これ 
じ 従う かぎり、 問題は 起きません。 

〇 同様に、 タスク が 切り 替わ った あとの time 闡 連の ライブラリ 内 
部 変数の 内容は 保証され ません。 必要に応じて 別の 変数に 保存す 
るよう じして く ださい。 あとで 述べる 方法で OBJC 型の モジュール 
を 作成した 場合、 これらの 制限は いっさい 生じません。 

〇  IOCS/DOS/SCSI コール 等は 一部を 除いて 使用で きません。 SX- 
WINDOW では、 IOCS/DOS/SCSI コール 等を 使って 直す 妾 画面に ア 
ク セス したり、 デバイスを 操作す る こと 力、* 一部を 除いて 禁じられて 
います5)。 これを 守らなかった 場合、 SX- WINDOW のク リーナの 
動作が お かしく なったり、 あるい は画而 かぶ しれた りするな ど、 SX- 
WIND0W の 使用に 支 峰を きたす 可能性が あリ ます。 SX-WINDOW 
のよう な ウィン ドウ システムでは、 Look 公 Feel の ガイ ドラ イン6) を 
守る ことが 大切です から、 禁止され た コールは 使用し ないで くだ 
さい。 具体の にどの コ ー ルが 使用禁止 なのか じついて は Workroom 
の マニュアルを 参照して く ださい。 
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OBJR 型 心外の モジュールの 作成 


LIBSXC を 使用して 実行 ファ イ ルを 作成した 場合、 デフォルト では OBJR 
型の モジ ュール じなり ます。 OBJR 型 U 外の モジ ュー ルを 作成した い 場合 
には、 モジュール タイプを 明示的に 指定す る 必要が あり ます。 

たとえば、 0BJC 型 モジュールを 作成したい 場合 じは、 


List  4-18  •  objc.s：  OBJC 型 モジ ュー ルの 指を 

1： .xdef  OBJECTTYPE 
2；  OBJECTTYPE  .equ  ，日 BJC， 


といった アセンブラの ソースを 作成し、 他の ファイルと いっ しょじ リン 


ク します。 


7)SX-WIND0W 用の アプ 
リ ケー シヨ ンの 動作に 
必要な、 最低限の ネ刀期 
化を 行う プロ グラムで 
す。 


8)main 関数に 実行が 移 
る 前に、 ライブラリ 内 
部 変数の 初期化 等、 必 
要な 処理を 行う ルーチ 
ン です。 


gcc  -SX  foo.c  obic.s 


OBJO 型の モジ ュー ルを 作成す る 場合 も 同様にし ます。 


カーネルの 変更 


SX-WINDOW 用の アプリケーションは、 SX シェル （SXWIN.X) から 起 
動す るの が 普通 です が、 Human68k 上で SX-WINDOW 用の プログラム 


9) 最も 単純な 力ーネル。 


10)  SX  シェル (SXWIN.X) 

と 同等の 環境を 提供す 
る デバッグ 用 カーネル 
です。 実は SXWIN.X 
を SXWDB.X じリ ネー 
ムした ピ けの  ものです。 

11) "一17" (ま、 SYSTEM. し B, 
BUILTIN.LB,  ICON . LB 
を メモリ じ 読み込む、 
という オプションです。 


を 開発して いる 場合、 デバッグの ためじ コマン ドライ ン から 起動す る こ 
とが 多 くな リ ます。 

コマンド ラインから 起動した 場合、 SX-WINDOW の々ー ネル7) を 起 
動し なければ なり ません が、 これは LIBSXC の スター ト アップ ルーチン8) 
が嫂理 します。 LIBSXC の 場合、 デフォルトでは" sxkernel"  9) という 
ファ イ ル 名の カーネルが 実 斤され ます。 

たとえば、 々ー ネルと して" sxwdb" 10) を 起動し、 さら じ々ー ネルに 
がして‘‘- 17" 11) という オプション じ） を 指定す る 場合、 


r  List  4-19  •  kernel . c: デバ ッ ク用 力ーネル を 用いる 


12) カーネル じがす るオプ 
シヨ ンの 詳細は、 Work¬ 
room  の マニュアルを 参 
照して く ださい。 


1 :  common  const  char  _sxkernelcomm []  =  "sxwdb  -If'' ; 


といった C の ソースを 作成し、 他の ファイル といつ しょじ リンクし ます。 
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gcc  -SX  foo.c  kernel. c  j 

アプリケーション 觸 発の 初期段階では、 起動の 速い "sxkernel" を 使 
い、 完成に 近づく につれ、 実際の 環境に 近い "sxwdb" を 使うよう にす る 
と よいでしょう。 


( / モ U の 動的 確保^ 


13) コ ラム 「SX— WINDOW 
の メモリ 管理と mal 
locj  (P.I30) を 参照し 
てく ピ さい。 


LIBSXC では、 LIBC の ヒープ 関係の 闕 数を 改良す る ことで SX-WIN 
DOW の 環境への 適応を 試みて います 口)。 実際の 使用に 際して は、 普通 
じ 皿 alloc 関数 や free 関数を 用いる ことができ、 次の 2 点を 除いては 
特にを 意すべき ことは あり ません。 


14) LIBC の ヒープ 領域を 
ネ 旨す 内部 変数です。 

15) LIBC  では  Boundary 
Tag  Method という 方 ま 
を もと じして います。 
Boundary  Tag  Method 
じついて は、 LIBSXC 
の ソース  src/stdlib 
/malloc. C 【こ 詳細な 
記述が あるので、 適 直 
参照して くた •さい。 

16)  複数の 要素が 手を つな 
いで I 列に 並んで いる 
ような デー タ 構造の 二 
とです。 を 要 索が 手を 
つないで いるので、 先 
頭から 順番に 要素を た 
どって いく ことができ 
ます。 


17) これが 「手」 じ 相当し 
ます。 


〇  LIBSXC では LIBC とは 違う ヒープ 管理を しています。 起動時 オプ 
ション や、 ライブラリ 内部 変数 -heapsize によって 指 
定、 確保され る LIBC の ヒープ 領域は 使用され ません。 

デフ ォル ト では、 この ヒープ 領域の サイズは 0 になって います。 

Obrk 関数 や、 sbrk 関数と いった、 ヒープを 拡張する ような 関数は 
使用し ないで ください。 これらの 関数は LIBC の ヒープ 領域を 対 
象と しています。 LIBSXC では 安全の ため、 これらの 関数が _hsta 
〜 -last 〜 _mmax I4) の 間で つねに 成功す るよう に 変更 して あり 
ますが、 すでに 述べた ようじ、 使用され ない 領域を いくら 操作し 
て も 無意味です。 

LIBSXC の ヒープ 領域は 必要に応じて 自動的に ホ 広 張され るので、 brk 
関数 や sbrk 関数 を 使う 必要は あり ません。 

次に LIBSXC の 扱う ヒープ 領域の 構造に ついて、 少 し 詳しく 説 巧し ま 
す。 ただし、 LIBC の ヒープ 領域の 構造 け） を 理解して いるものと 仮定し 
て 話を 進めます。 

LIBSXC では、 Fig.  4-3 のように、 複数の 不連続な ヒープ 領域が リスト 
構造 le) でつな がって います。 各 ヒープ 領域は、 前の ヒープ 領域への ポイ 
ンタ I7) と、 ヒープ 本体と から 構成され ています。 
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Fig.  4-3  •  LIBSXC の ヒープ 領域 


—阳 a_ip こ r 


18)  おのおのの ポインタが 
I つ 前の 領域の みを 指 
し、 要素を 後ろから 前 
じし かたどって いけな 
いので 「举 方向 リスト」 
といい ます。 ほかに 双 
方向 リス トや 環状 リス 

卜 があります。 

19)  つまり、 わの おのの ヒ 
ープ 領域は 再配置 不可 
能な ブロックです。 


ライ ブ ラリ 内部 変数 -ma_lptr 力ぶ 最後の ヒープ 領域への ポイ ンタを 保 
持して いて、 全体として 単 方向 リスト IS) を 形成して います。 ヒープ 本体 
は LIBC の それと まったく 同じです。 

malloc 関数な どじ よって メモリ ブロック の 確保 力 《要ボ される と、 LIBSXC 
は これらの ヒープ 領域から 適当な 空き ブロックを 探して きます。 ヒープ 領域 
中に 空き ブロックが 見つからない 場合は、 SX コール MMChPtrNew の） によ 
リ 新たな ヒープ 領域を 確保し、 そこから 空き ブロックを 探します。 新たに 確 
保され る ヒープ 領域の サイ ズ は、 ライブラリ 内部 変数 -SX-GETMEM-SIZ 巨 
によ っ て 指定す る こと がで きます。 

〇  size.t  _SX_GETMEM_SIZE 

新たに 確保す る ヒープ 領域の サイ ズを バイ ト 単位で 指定し ます。 
デフォルトは 32K  (32768) バイ ト です。 ヒープ 領域を 確保す るた 
びに 参照され るので、 実 斤 中で も 随時 変更す る ことが 可能です。 
_SX_GETMEM_SIZE の 値を 超える ヒープ 領域が 必要な 場合は、 その 
分 だけ 確保され ます。 


プログラムに よっては、 一時的に malloc で 大量の メモリ を 確保した 
あと、 すぐに 大半を free じして しまう ことがあ ります。 このような 場 
合、 ある ヒープ 領域 全体が 完全に 未使用 状態に なって しまう こと も 考え 
られ ます。 このような ヒープ 領域を そのまま じして おく と メモリの 無駄 
になる ので、 LIBSXC では 適当な タイ ミ ングで 空の ヒープ 領域を 削除し 
ます。 実際に 削除が 行われる のは、 free が 実行され たと きです。 また、 
プログラム 終了が には、 すべての ヒー プ 領域が 自 動的に 削 除され ます。 

そのほかの LIBSXC の ヒープ 管理に 関する 詳細は、 LIBSXC ソース コー 
ド パッケージ 中の、 じ [下の ソースファイルを 参照して く ださい。 

し） src/stdlib/_ 皿 a_new .  C 
KJ  src/sxstartup/_exit . C 
し） _getmem_size . C 
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O  _sx_killheap. c 


本節の 最初で も 述べた ように、 LIBSXC の 実際の 使用に 際して は、 ご 
く 普通に mal い C 関数 や free 関数を 用いる ことができ るよう に 設計し 
てあります。 あまり 雛し く 考えず、 気輕に 使用して ください。 

々ー ネルの 変更 や モジ ュー ルタ イプの 変更は、 SX-WINDOW に関する 
ある 程度の 知識を 必要と します。 自分が 斤う 変更に よって 何が 変わる の 
かを 正しく 理解して から 使う ようにし てく ださい。 
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APPENDIX  A  SX31KIT 


GO 


SX31KIT 構造体の 定義 


SX31KIT で 新たに 追加され た 構造体 名を Table  A-1 に 示します。 


Table  A-1 •  SX31KIT で 追加され た 構造体 


構造体を 

ヘッダを 

内を 

CRGB 

COLOR. H 

RGB レコ ー ド 

CInfo 

COLOR. H 

々ラー レコード 

Palet 

COLOR. H 

/，レツ ト レコ ー ド 

pltlList 

COLOR. H 

ノ 、。レツ ト テン プ レー ト 

cPick 

COLOR. H 

々ラー ピックアップ ルーチン 用 

ErrPat 

DIALOG. H 

ユー ザを 義 アニメー ション 

ErrBtn 

DIALOG. H 

ューザ 定義 ボタン 

PrDl 

PRINT. H 

プリンタ ダイアログ レコード 

GraphGlobal 

SXGRAPH.H 

グラフマン グローバル ワーク 

Cpdf Info 

SXGRAPH.H 

CPDF リ ソース 情報 

Gsinfo 

SXGRAPH.H 

GScript  情報 

DPatPac 

SXGRAPH.H 

ディ ザ パ ターン の アイテム 情報 

DPattern 

SXGRAPH.H 

ディ ザ パターン 情報 

CODFInfo 

TASK.H 

CDDF リ ソース 情報 

COIF 

TASK.H 

COIF リ ソース 情報 

cCell 

TASK.H 

圧縮され た セルの デー タ 構造 

MTEdit 

TEXT.H 

マルチ フォン ト テキス ト エディッ トレ コード 

TEScrap 

咒  XT.H 

テキス ト エディッ トス クラップ レコー ド 

TEStyle 

咒  XT.H 

スタイル 情報 レコード 

咒 LStyle 

咒  XT.H 

文字 サイズ 付き スタイル 情報 レコード 

TEOption 

咒  XT.H 

オプション 情報 レコー ド 

咒  Page 

咒  XT.H 

ページ 情報 レコー ド 

Videoinfo 

VIDEO. H 

ビデオ 情報 レコー ド 

VideoSampleInf  o 

VIDEO. H 

ビデオ サンプル 情報 レコード 

HWindow 

WINDOW. H 

階層 ウィンドウ レコード 
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マクロの 定義 


SX31KIT で 定義され る マクロ 名と その 役割を Table  A-2 に 示します。 


化 ble  A-2  •  SX31KIT で定 巧され る マクロ 名 


マクロを 

ヘッダ 名 

役割 

__SX31KIT__ 

SXDEF2.H 

SX31KIT の ヘッダを 用いて いる ことを 示します。 現 
かは 「し が 定義され ています。 

SXVER2 

TASK.H 

Workroom と 同様に、 動作 可能な SX システムの 
バー ジョン 0x0201 が 定義され ています。 

SXVER3 

TASK.H 

動作 可能な SX システムの バー ジョン 0x030a がを 
義 されて います。 

__MTEDIT_T 

TEXT.H 

この マクロが 定義され た 場合、 マルチ フォント テキ 
ス ト エディ ッ トレ コー ドの 定義が 変 おされます。 

ここで、 マクロ 名 __MTEDIT_T の 役割に ついて 補足して おきます。 

SX31KIT では、 互換性を 保つ ため マルチ フォント テキスト エディット レ 
コー ドを 表す 構造体 MTEdit を 従来の テキス ト エディ ッ ト レコード TEdit 
を拡 •張す る 形で 宣言して います。 しかし、 「 SX-WINDOW  ver.3.1 シス 
テム キット」 （シャープ） や 「シャ ー"" ^ン ワープロ パック」 （計測 技研） に 
含まれて いる インクルード ヘッダ MT 邸 IT.H では、 TEdit とは 闕 係な 
く、 MTedit を 宣言して います。 SX31KIT では マクロ 名 __MTEDIT_T を 
定義す ると、 構造体 MTEdit を 後者の 形式で 宣言し ます。 なお、 マクロ 
名 __MT 邸 IT_T を 使用 するとき は、 必ず マク ロ 名 SX31KIT を チェックす 
るよう じして ください。 
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の 


ビデオ マン 関係の マクロ 


SX31KIT では、 Table  A-3 に 示す よう な ビデオ マン 用の マク ロを イン 
クルー ド ヘッダ VIDEO. H で 定義して います。 


化 ble  A-3  • ビデオ マン 閱 係の マクロ 


マクロ 名 

役割 

VMSetDuration 

VMSetTimeScale 

VMSetRate 

VMSetCurTime 

VMSetPlayRect 

VMSetUserAtom 

VMSetParam 閒数 用の マクロ 

VMGetDuration 

VMGetTimeScale 

VMGetRate 

VMGetCurTime 

VMGetUserAtom 
VMGetWidthHeight 
VMGet Status 

VMGetMediaMode 
VMGetTotalSample 
VMGet Cur Sample 
VMGetTotalFrame 

VMGetParam 脚 数 用の マクロ 

VGetPlayRect 

VMGetFrameDuration 

VMGetParam2 脚 数 用の マクロ 
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1) Charlie 氏が 移植した 
良 CC  ver.2 系統の C/ 
C+  +  /Objective— C  コン 
パイ ラ。 添付 CD-ROM 
じ 収録され ています。 


SX31KIT は、 gcc2 リ などの C+十 コンパイラ でも 利用す る ことができ 
ます。 


C++ で SX31KIT を 利用す る 場合 じは、 イ ン クルー ド ヘッダを 取り込む 
プリ プロ セツ サ 命令 #include の 前後を extern  "C"  {} で 閒んで 利用 
する ようにして ください。 


extern  "C"  { 

¥#include  <sxdef2.h> 


}； 


0 コラ 厶： アセンブラ マクロ ファイル 


SX31KIT じは、 アセンブラで 關 発す 
るのに 必要な マク ロ ファイル も 含まれて 
います。 アセンブラ マクロ ファイル じは、 
大きく 分けて 2 つの 利用 目の が あり ます。 
1 つは、 アセンブラ 言語を 用いた プ ログ 
ラム 削 発で 直接 利用され る 場合、 もう 1 
つは C 言語を 用いた プログラム 閒 発の 際 
じ C コ ン パイ ラから 間接が パ こ 利用され る 
場合です。 SX31iaT にか 厲 する ア セン 
ブラ マクロ ファイルは、 Workroom 村. 厲 
の アセンブラ マクロに 対する 上位 互換を 
保ちつつ、 SX-WINDOW  ver.3.1 で帮た 
に 追加 された 機能を アセンブラから 利用 
できる ように 設計され ています。 

SX31KIT じ 村 •儀す る アセンブラ マク 
ロ ファイル にはの i 下の ものが あり ます。 

OSXCALL.H 

アセンブリ 言語を 用いて プログラムを 
作成す る 際に 説み 込む マク ロ ファ イ ルで 


す。 各種の 定数 定義 や、 データ 構造の 定 
義を 斤って います。 C 言語から 使用され 
る ことは あり ません。 

OSXCALL.MAC 

SX コー ルを 号、 コール 名と その マク 
口を 記述した ファイルです。 アセンブリ 
言語を 用いて プログラムを 作成す る 際に 
読み込みます。 C 言 請から 使用され る こ 
とは あり ません。 

OSXCALL.EQU 

gcc を SX モー ドで 動かした 場合に 
gcc が 使用す る アセンブラ マクロ ファ イ 
ルです。 .正祕 : じは gcc がか, 力す る ア七ン 
ブラフ ァイ ル か ら アセンブラ じ よって 読み 

込まれます。 SXCALL.EQU では 主に SX 
コー ルの コ ール 番号 を 定義 しています。 

SXCALL.EOU  は、 内部で  D0SCALL. 
EQU を 読み込む よう になって います。 
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APPENDIX  A  SX31Krr 


2)gcc2 じ なって enum 型 
の 言語 上の 定義が 変更 
された ため、 そのまま 

では コンパイル エラー 

になる からです。 

SX31KIT のイ ン クルー ド ヘッダ 内部では、 マクロ 名— GNUG— が 定義 さ 
れ ている かどう かを チェックし、 定義され ていれば gcc2 であると 判断して 
‘‘typedef  enum 列挙 型 名 型 名’’ の 定義を 省略 します2)。 Workroom のイ 
ン クルー ド ファイルを そのまま 利用して いる CONSOLE.  H,  CONTROL.  H, 

EVENT.  H,  RESOURCE.  H,  SXMEMORY.H について は、 この 変更を 各自で 

行って ください。 
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B.1 LIBSXC の 活用の ために 


ここでは、 LIBSXC をより 高度に 活用したり、 あるいは LIBSXC を 使 
用して いて 問題が 起こった 際の 解決の 糸口 に 利 用で きる 情報 として、 次 
の 項目を 取り上げます。 

(1)  実行 ファイルの 構造 

LIBSXC を 使用した 実 巧 ファ イ ルの 構造 じついて 説明 します。 

(2)  実 巧 -1 卜 本の メモリ マップ 

LIBSXC を 使用した プログラムの、 実行時の メモリの 状態に ついて 
説明し ます。 

(3)  スター ト アップの プロセス 

LIBSXC を 使用した プログラムを 起動した ときに、 ライブラリ が ど 
のよう な 準備 をす るかに ついて 説明し ます。 

(4)  まな ライブラリ 内部 変数 

LIBSXC を 使用した 場合に、 プログラム 中から 参照で きる ライブ ラ 
リ 内部 変数 じついて 説明し ます。 

ただし、 これらの 内部 情報を 利用す ると、 LIBSXC ライブラリの バー 
ジョン や、 特定の 動作 環境に 依存す る ことにな り、 互換性が 損われる 可 
能 性が あるので 注意して く ださい。 
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APPENDIX  B  LIBSXC  便利帳 


Fig.B-1 に LIBSXC を リンク した 場合の 実行 ファイルの 構造を 示します。 

F お. B-1 •  LIBSXC をり ンク した 巧 合の 実行 ファイルの 構造 


(a) から 似 の 各 セク ショ ンの 内容は 次のと おり です。 

(a)  実斤フ ァイ ル ヘッダ 

Human68k の コマンド ライ ン から 起動す るた めに 必要な ヘッダです。 
SX— WINDOW の モジュールへ ッ ダでは あリ ません。 

(b)  text セク ショ ンの 巧を 

プログラム 本体です。 SX-WINDOW の モジ ュ_ ルへ. ソ ダは この 部 か 
に 含まれます。 

(C) セク ショ ン 情報 

リンカ 011 k) が 化 力す る セク ショ ン 情報です。 相対 セ クシ ョンを 含 
む、 各 セクションの サイズが 記述され ています。 

(d)  rdata セク ショ ンの 内容 

オフ セッ トが 64K バイ ト 巧の 初期 イヒ 済み データ セクションの 内容 
です。 

(e)  rldata セク ショ ンの 内容 

オフ セッ トが 64K バイ トを 超える 初期 イヒ 済み データ セクションの 内 
容 です。 

び） 相対 オフセット （roffset) テーブル 

相対 セク ショ ンを 初期化す る 際、 ア ドレスに 依存す る 部 かを 補正す 
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るた めの テーブルです。 


B.2 実行 ファイルの 構造 


(g)  data セク シヨ ンの 内容 

通常の 初期 イヒ 済み データ セク シヨ ンの 内を です。 

(a)、 （b) および （g) は 通常の 実行 フ アイ ルと 同 じです。 （C) からび） は、 
LIBSXC 独自 （正髓 には X680x0  gcc 独自） の 部分で、 rdata を はじめと 
する 相が セ クシ ヨンの ためにあります。 相対 セ クシ ヨンに 関する 詳細は、 
コラム 「セクション」 （P.23) を 参照して ください。 
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実行時の メモ IJ マツ 


1) プロ グラ厶 実行時の、 
メモリ の 状態 図の こと。 


2) たとえば、 "common 
int  a  = 1;" と いつ 
たもの。 


3) たとえば "common 
int  a;" といった も 
の 0 


タスク 間で 共有され る 領域^ 


Fig.  B-2 に、 LIBSXC を リンクした プログラムを 実行した 場合の タス 
ク 間で 共有され る 領域の メモリ マップり を 示します。 


Fig.  B-2  •  LIBSXC をり ンク した 巧 合の プログラム 実行時 じ、 タスク 間で 共有され る 領域 


(a) テキス ト （ブロ グラム コー ド） 
セクション 

1  dsta 

(b) 初期化 巧み データ セクション 

rdata 

rldata 

rof fset 

data 

，  bsta 

(Cl 初期化な し データ セクション 

bss 

stack 

(a) から （C) の 各 セ クシ ョ ンの 内容は 次のと おり です。 


(a)  テ ネスト （プログラム コー ド） セクション 

プログラム 本体が 格納され ています。 この 領域の 先頭 ア ドレスは、 
ライブラリ 内部 変数 -psta が 指 しています。 

(b)  初期化 済み デ ー タ セクション 

あらかじめ 内 容 がわ かってい る 共用 大域 変数2) が 格納 されて います。 
この 領域の 先頭 ア ドレスは ライブラリ 内部 変数 -dsta カタ 旨して い 
ます。 


(C) 初期化な し データ セクション 

あらかじめ 巧を がわ かってい ない 共用 大域 変数3) が 格納 されて いま 
す。 この 領域の 先頭 ア ドレスは ライブ ラ リ 内部 変数 -bsta が 指して 
います。 
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B.3 実行時の メモリ マツ フ 


( タスク ごとに 確保され る 領域） 


Fig.  B-3 に、 LIBSXC を リンクした プログラムを 実 斤した 場合の タス 
ク ごとに 確保され る 領域を 示します。 

Fig.  B-3  •  LIBSXC をり ンク した 巧 合の プログラム 実行時 じ、 タスク ごとに 確保され る 領域 


( 1 ) 巧 巧 化-; るみ デー タ セクション 
rdata 

—  _rds 仁 a 

(2) 初期化な し デー タ セクション 
rbss 

rcomm 

^  ~rbsta 

(3) スタック セクション 
rstack 

< rssta 

(4) 巧 期 化 済み データ セクション 
rldata 

rldsta 

(5) 巧 期 化な し データ セクション 
rlbss 

rlcomm 

^ rlbsta 

(6) スタック セクション 
rlstack 

4  一 r 王 55 じ a 

(7>  巧 巧を 巧 バッファ 

< esta 

(8) 巧 巧ず 巧べ クタ バッファ 

^ fsta 

(9) スタック エリア 

_stacksize 

*• ssta 

(10) ヒ ープエ リア 

— heapsize 

^ hsta 

-last 

4) たとえば、 "int  a 
1;" といった もの。 


5) たと え ば、 "int  a; 
といった もの。 


(1) から （10) の 各 領域の 内容は 次のと おり です。 

(1)  初期 イヒ 済み デ ー タ セクション 

あら かじ め 内容が わ かってい る タスク ごとの 大域 変数4) が 格納され 
ています。 この 領域の 先頭 ア ドレスは ライブラリ 内部 変数 _rdsta 
力ぶ 指* しています。 

(2)  初期化な し データ セクション 

あら かじ め 内容が わ かってい ない タスク ごと の 大域 変数5) が 格納 さ 
れ ています。 この 領域の 先頭 ア ドレスは ライブラリ 内部 変数 _rbsta 
力ぶ 指 ■しています。 

(3)  スタック セクション 

この 領域は LIBSXC では 使用され ません。 領域の サイズ も 0 です。 
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APPENDIX  B  LIBSXC  便利帳 


実行時の スタックと しては （9) の 領域の みが 使用され ます。 この 領 
域の 先頭 ア ドレスは ライブラリ 内部 変数 -rssta 力 指して います。 


6) たとえば、 "remote 

i 且 t  a  = 1 といつ 
たもの。 


7) たとえば、 "remote 
int  a;" と いった も 
の。 


(4)  初期 イヒ 済み デ ー タ セクション 

あら か じめ 内容が わか っ ている タスク ごと の 大域 変数6) が 格納され 
ています。 こ の 領域の 先頭 ア ドレスは ライブラリ 内部 変数 -rldsta 
力づ t しています。 

(5)  初期化な し データ セクション 

あらかじめ 内を がわ かってい ない タスク ごと の 大域 変数7) 力 叫各納 され 
ています。 この 領域の 化頭ア ドレスは ライブラリ 内部 変数 -rlbsta 
力 《 指して います。 

(6)  スタック セクション 

この 領域は LIBSXC では 使用され ません。 領域の サイズ も 0 です。 
実 巧り 本の スタックと しては、 （9) の 領域の みが 使用され ます。 この 領 
域の 化頭ア ドレスは ライブラリ 内部 変数 -rlssta 力 《キ旨 しています。 

(7)  環境 変数 バッファ 

タスク が 起動 したと きに 親 タスク が 持って いた 環境 変数の 情報が、 
引数 ごとに NULL キャラクタで 区切られて 格納され ています。 main 
関数の 第 3 引数の 各 要素の 実 f 本で も あり ます。 この 領域の 先頭 アド 
レスは ライブラリ 内部 変数 _esta が 指して います。 


(8)  環境 変数べ クタ バッファ 

(7) の 環境 変数 バッファに 格納され た 環境 変数のを 要素への ポインタ 
が、 配列と して 格納され ています。 main 関数の 第 3 引数の 各 要素で 
もあります。 この 領域の 先頭 ア ドレスは ライブ ラ リ 内部 変数-； fsta 
力ぶ 指* しています。 

(9)  スタック エリア 

タスクが 実行時に 使用す る スタックと して 使用され る 領域です。 この 
領域の 先頭 ア ドレスは ライブラリ 内部 変数 -ssta 力 3' 指して います。 
MC680X0 では、 スタックは 下位 ア ドレスに 向かって 消费 される ので、 
実際には この スタック セク ショ ンの 最後から 順次 使用され ます。 ス 
タッ クポイ ンタ が、 スタック エリ ア の- 先頭を 越えて しまったが 態を 
「スタック オ ーバー フロー」 と 呼びます。 この場合、 （2) や （1) の 領域 
が 破壊され る ことにな り、 さらに オーバーフローが 進む と 他の タス 
クの 領域まで も 破壊して いきます。 
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B.3 実行時の メモリ マッフ 


スタック セクションの サイズは、 ヒープ 領域と 違って、 足りな くな っ 
たからと いって 動的に 増やす ことは でき ません ので、 スタック をた 
く さん 消贊 する よう な プロ グラムでは、 あらかじめ スタックを 多め 
に 確保す るよう にして ください。 なお、 デフォルトの スタックの サ 
イ ズは 32K バイ ト です。 

(10) ヒープ エリア 

この 領域は LIBSXC では 使用され ません。 領域の サイズ も 0 です。 
この 領域の 先頭 ア ドレスは ライブラリ 内部 変数 _hsta 力づ 旨して いま 
す。 LIBSXC の ヒープ 領域に ついては、 「メモリの 動 fl 勺 確保」 （P.150) 
を 参照して ください。 
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l)main(int  argc, 
char*  argv  [] , 
char*  envp 口） の 
argc  と  argvG 


プログラムが 起動して から 扭 ain 関数が 実行され るまで じ、 LIBSXC の 
スタート ア ップ ルーチンが 斤う 動作に ついて 順に 説明し ます。 

(1)  力ー ネルの 起動 

Human68k の コマン ドライ ン から 起動 さ れた 場合、 ここから 実行 
されます。 まず、 指定の カーネルを 起動し ます。 カーネル 起動 後、 
モジュール ヘッダに 記された アドレスに 飛びます。 SX シ卫ル 上で 
起動した 場合、 カーネルを 起動す る 必要はありません から、 次の 
「(2) ワーク エリアの 確保」 から 実行され ます。 

(2)  ワーク エリアの 確保 

セク ショ ン 情報を も とに タスク ごとに 必要な ワーク エリアの サイ 
ズを 計算し、 再配置 不可能な ブロックを 1 つ 確保し ます。 確保され 
た ブロ ッ ク への ハン ドルは、 ライブラリ 内部 変数 -data-hdll に 
格納され ます。 さら に 確保 された ワーク エリアの 先頭 アドレスに 
0x8000 を 足した 値が A5 レジスタに 代入され ます。 これは タスク 
ごとの 変数が、 A5 レジスタ 相対 ア ドレ ッ シングで アクセス される 
ためです。 

(3)  ワーク エリアの 初期化 

次に 「(2) ワーク エリアの 確保」 で 確保され た タスク ごとの ワーク 
エリアを 初期化し ます。 タスク 間で 共有 領域に ある rdata,  rldata 
セク ショ ンの 内容を、 タスク ごとの ワーク エリアに コピーし ます。 
また、 rbss,  rlbss 領域を クリアし ます。 

(4)  コマンド ライ ンの 解析 

コマン ドライ ン 文字列を 解析し、 main 関数に 渡す ための 引数べ ク 
夕 りを 作成し ます。 これらの 領域は rbss 中に 置かれます。 

(5)  環境 変数 お よび スタック エリ アの 確保 

環境 変数 および スタック エリアに 必要な サイズを 計算し、 再配置 
不可能な ブロックを 1 つ 確保し ます。 環境 変数と スタック エリア 
は、 ともに この 再配置 不可能な ブロック のなかに 置かれます。 確保 
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B.4 スタ ーh アップの プロセス 


2) 田 ain(int  argc, 
char*  argv  LJ  , 
char*  envp  [] ) の 
envp  [] 


された ブロ ッ ク への ハン ドルは、 ライブラリ 内部 変数 _data_lidl2 
に 格納され ます。 

次に、 虹 ain 関数に 渡す ために、 環境 変数を コピーし、 環境 変数べ 
クタ2) を 作成し ます。 さらに、 実行時の スタック として SP(A7) レ 
ジ スタを 設定し ます。 

(6)  main 関数の 実 斤 

その他 必要な ライブラリ 内部 モジュール や 内部 変数を 初期化した 
あと、 main 関数が 実行され ます。 

(T) 後化理 

皿 ain 関数 終了後、 オープン した ままの ファイルを クローズ したり、 
ヒープ 領域を 開放す るな どの 後化理 をした あと、 「り） ワーク エリア 
の 確保」 や 「(日） 環境 変数 エ リア およ びス タック エリ アの 確保」 で 
確保した ハンドルを 開放し、 TSExit を コールして 終了し ます。 

そのほか、 LIBSXC の スタート アップ ルーチン に関する 詳細は、 LIBSXC 
ソース コー ド パッケージ 中の じ I 下の ソースファイルを 参照して く ださい。 

〇  src/sxstartuD/_start .  C 
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APPENDIX  B  LIBSXC  便利帳 


LIBSXC の ライブラリ 内部 変数は、 LIBC です でに 公開され ている も 


1) ソフト バ ンク刊 「X 
680x0  libcj 「X680x0  De 
velop  &  libc  II j  を 参照 
してく た’ さい。 


の 1) に闕 しては、 LIBSXC でも その 役割 や 内容は ほぼ 同じです。 した 力 s' っ 
て、 ここでは LIBC とは 働きが 違う もの や、 LIBSXC 独自の ものに つい 
て 説明し ます。 


〇  OBJECTTYPE 

モジ ュー ルへ ッ ダ [巧の モジュール タイ' 7° を 指* 定 します。 デフ ォルト 
では "0BJR" になって います。 

〇  _C0MM0N_SIZE 

モジュールへ ッ ダ 巧の コモン エリ アの サイ ズを 指定し ます。 gcc の 
SX モー ドに おける コモン セクションとは 異なり ますので 注意して 
ください。 デフォルトの サイズは 0 です。 

〇  extern  int  .common; 

SX-WINDOW によって 確保され た コモン エリアへの ポイ ンタ です。 
プログラム 起動が に、 SX-WINDOW によって 自動的に 設定され る 
A4 レジスタの 値が 代入され ています。 

〇  extern  common  char  _sxkernelcomm[] ; 

Human68k の コマン ドライ ン から 起動され た 場合に 使用す る々 ーネ 
ルを 指定し ます。 デフォルトでは "sxkernel" です。 詳細は て カー 
ネルの 変更」 （P.149) を 参照して く ださい。 

〇  struct  _mep  _inemcp;  /  struct  _psp  _procp; 

それぞれ々ー ネルの プロセスの メモリ 管理 ポイ ンタ、 プロセス 管 
理 ポインタを 指して います。 つまり、 sxwin.x や sxkernel .x に 
関しての 情報であって、 タスク それ 自身の 情報では あり ません。 

〇  extern  long  _pid; 

自分自身の タスク ID です。 プログラム 起動時に SX-WINDOW に 
よって 自動的 じ 設定され る DO レジスタの 値が 代入され ています。 
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〇  extern  long  _ppid; 


B.5 主な ライブラリ 内部 変数 


コー ドを 共有す る タスクの ID です。 プロ グラ ム 起動時 じ、 SX-WIN 
DOW によって 自 動的 に 設定され る D1 レジスタ の 値 力ぶ 代入 されて 
います。 

〇  extern  void*  _rdsta;  /  extern  void 本  _rbsta;  /  extern 
void 幸  _rssta;  /  extern  void 本  _rldsta;  /  extern  void* 
_rlbsta;  /  extern  void 幸  _rlssta; 

タスク ごとに 蹄 i 保され たを 相対 セク ショ ンの 先頭 ア ドレスです。 

〇  extern  void*  _data_hdll ; 

タスク ごとに 確保され る ワーク エリ ア への ハン ドルです。 

〇  extern  void*  _data_hdl2; 

タスク ごとに 確保され る 環境 変数 および スタック エリ ア への ハン 
ドルです。 

〇  extern  common  sizeinf o_t  __size_ 1111 〇; 

リン々 （hlk) が 出力す る 相が セク ショ ン 情報です。 sizeinfo_t 構 
造 体は 次のと おりで、 それぞれの メ ンバは 各 セ クシ ヨンの サイズ 
を 示して います。 


typedef  struct  i 
size_t  text ; 
size_t  data; 
size_t  bss; 
size_t  comm; 
size_t  stack; 
size_t  rdata; 
size_t  rbss; 
size_t  rcomm; 
size_t  rstack; 
size_t  rldata; 
size_t  rlbss; 
size_t  rlcomm; 
size_t  rlstack; 
size_t  roff set ; 
size_t  reserved L2J ; 

}  sizeinf o_t; 

ia 上の ライブラリ 内部 変数は、 プログラム 起動時に 初期化され、 実 斤 
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中に その 内容が 変わる ことは あり ません。 これらの 変数は ライブラリの 
実 斤に 深 く 関わって いるので、 不用意に 書き換え た 場合の 動作は 保証で 
きません。 

これらの ライブ ラ リ 内部 変数の 利用は 参照の みに とどめて く ださい。 
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SX-WINDOW 巧応フ リー ソフト 

— 見 


これまで、 多くの フリーソフト ウュア 作者の 手 じよって、 さまざまな 力 
作が SX-WINDOW のために、 あるいは SX-WINDOW を プラッ トフ ォー 
ム  にして 開発され てきました。  本節では、 これらの フリーソフトウェア 
の 一寛を 示します。 なお、 ここに 示した フリーソフト ウ卫ア は、 本書に 
添が の CD-ROM に 収録 されて います。 


No.l 

3D グラフ .X 

分類 

¥APL¥3DG  民  APH 

作者 名 

高 橋蹲樹 （HI-Br.) 

対応 0S 

SX  2.0  U 上 

収録の 容 

別途 ソースファイル 同 欄 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SXCalc.X  (カップ めん 氏 作） や CGraph.X  (嵩 橋博樹 （HI-Br.) 氏倘 の データを 
もと じして 3D 棒グラフ や 巧れ 線グラフを 揣 幽する プログラム。 

No.2 

CALENDAR. X 

分類 

¥APL¥CALEN 

作者 名 

MAPI (小 野 嫁 正則） 

対応 OS 

SX  1.1  U  上 

収録 内を 

バイナリ のみ 

サポート ネット 

Network- SX  NG 

紹介 

12、 16、 24 ドットの 3 種類から フォントを 選が したり、 祝 田 や 振り替え 化 H を ホ 
で 表示したり、 か 【1 データ を 任 恵に 設を したりす る ことができる プログラム。 

No.3 

cddata.x 

分類 

¥APL¥CDDATA 

作者 名 

と一い 

対応 OS 

SX  3.0 肚 

収録 内容 

別途 ソースファイル 同 欄 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で CD (コン パク ト ディスク） の 1 曲目 管理と々 セッ ト テー プ、 MD (ミ 
ニ ディ ス ク)、 DAT などの ラベル 作成 支援を 行う プログラム。 

No. 4 

CGraph.X 

分類 

¥APL¥CGRAPH 

作者 名 

高 橋博樹 (HI-Br.) 

対応 OS 

SX  3.1 

収録 内容 

別途 ドキ ュメン トア ー々 イブ 
あり。 別途 ソースファイル 同 
削 

サポート ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 動作す るグラ フ描關 & 近似 式 計算 ツー ル。 

縮を 

グラフ メニユ ー .X 搞 梳憐樹 (HI-Br.) 氏 作)、 SXCalc  •  x  (々 ッ プ めん 氏 作） 対応、 
SX— BASIC  対応、。 
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No.5 

データ 間引 .X 

か颁 

¥APL¥DATAUTY1 

作者 名 

高 俯博樹 （HI-Br.) 

対応 0S 

SX  2.0 じ [上 

収録 内を 

バイナリ のみ 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SXCalc.X け ップ めん 氏 作） や CGraph.X  (高 橋博樹 （HI-Br.) 氏 作） の デー タを 
適宜 削除す る ユー ティ リ ティ プログラム。 

No.6 

非線形 近似 .X 

々類 

¥APL¥DATAUTY2 

作者 名 

高 梳博樹 （HI-Br.) 

が応 OS 

SX  2.0 じ [上 

収録 内容 

バイナリ のみ 

サポート ネット 

NIFTY-Serve 

紹介 

SXCalc.X  ( カ ップ めん 氏 作） や CGraph.X 搞 橋辟樹 （HI-Br.) 巧 作） に 入ん され 
た デー タから、 「y 二 a お n ぶ + わ cos ぶ +  ...」 のよう な 脚 数で 近似値を 作成 
する ための ユー テイ リ テイ プログラム。 

No.7 

SXdentaku.x 

巧 類 

¥APL 排 ENTAKU 

作者 名 

BAA 

が応 OS 

SX 义〇 じ [上 

収錬 内容 

ソースファイル 同 棚 

サポート ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で 動作す る、 少し 廚 機能な 電请 プロ グラム。 

No.8 

グラフ メニュ ー.X 

分類 

¥APL¥GMENU 

作者 名 

高 橋博樹 （HI-Br.) 

対応 OS 

SX  2.0  U 上 

収録 内容 

別途 グラフ モジ ュー ルアー々 
イブ あ リ。 別途 ソー スフ ァイ 
ル 同 欄 

サポート ネット 

NIFTY-Serve 

紹介 

SXCalc.X け ップ めん 氏 作） や CGraph.X  (高 梳隙樹 (HI-Br.) 氏 作） などの コピー 
データを 利用して グラフを 描關 する ための プログラム。 

備考 

SX-BASIC  が応。 

No.9 

SX-gnuplot . X 

分類  ¥APL¥GNUPLOT 

作者 お 

MAPI  (小 野 嫁 正刖） 

対応 OS 

SX  3.0 じ 1上 

収録 内容  バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

グラフ 作成 ソフト GNUPLOT の SX-WINDOW 版。 PAT4、 PIX 形式での セー ブ、 

ス クラ ッ プ への 転 •送が 可能。 

No.lO 

面 グラフ. X、 3D 円グラフ. X  II か锁 

1  ¥APL¥GRAPII 

作 おお 

离 橋憐樹 (HI-Br.) 

が応 OS 

SX  2.0 じ [上 

収録 内容 

別途 ソース ファイル 巧 刪 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SXCalc.X  (カ ップ めん 氏 作） や CGraph.X  (高 槪牌樹 （HI-Br.) 氏 作） などの コ ピー 
データを 利用 して 酣 グラフ、 3D  |リ グラフ を揣 晒す る ための プロ グラム。 

備考 

グラフ メニユ ー.X 偏 梳牌樹 (HI-Br.) 氏 作） 必須 ソフト。 
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No.ll 

3D 棒グラフ .X、 横棒 グラ 
フ .X、 レーダー型 グラフ .X 

分類 

¥APL¥GRAPH2 

作者 名 

肯; 橋博樹 （HI-Br.) 

が応 OS 

SX  2.0 じ 1 上 

収録の が 

別途 ソースファイル 同 欄 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SXCalc.X  ( カ ップ めん 氏 作） や CGraph.X  (高 梳隙樹 （HI-Br.) 氏 作） などの コピー 
デー タを 利用して 3D 棒 グラス 横棒 グラフ、 レーダー 型 グラフを 描 幽する ための 
プログラム。 

備考 

グラフ メニユ ー .X  (高 橋博樹 （HI-Br.) 氏 作） 必須 ソフト。 

N0.12 

MCZector .X 

分類 

¥APL¥MCZ 

作を 名 

仁 泉大輔 

が 化 0S 

SX  3.0  U 上 

収錄 内を 

別途 ソースファイル 同 棚 

サポート ネット 

NIFTY-Serve 

紹介 

SX— WINDOW 上で 動作す る、 ベクトル フォント に eit 社の フォント など） の マー 
ジ兼ク リ ーナ。 

N0.13 

メモリ メーター .X 

分類 

¥APL¥MEMG 

作者 名 

VSYNC 

が お OS 

SX  1.1 社 

収錄 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

を メモリ 容强、 使用可能 メモリ 容 愚、 連続 使用可能 メモリ 容感を グラフ ィ 々ルに 表 

7 でしたり、 メモリ ブロックの 配 饒 を 始適化 したりす る プログラム。 

N0.14 

田 VS1 .X 

分類 

¥APL¥MVSI 

作 あ 名 

けんと 

対応 0S 

SX  3.1 

収録 内容 

別途 ソース ファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW システム アイコ ンの 一部を アニメ ー シヨ ン させる プログラム。 

N0.15 

postSx.x 

分類 

¥APL¥POSTSX 

作を 名 

仁 泉大輔 

が応 0S 

SX  3.0  U 上 

収錄 内を 

別途 ソースファイル 同 欄 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

住所を パラメータと して 郵便 お 号を 検索. 表示す る プログラム。 

N0.16 

55 邸 .X 

分類 

¥APL¥SC55ED 

作者 お 

しゅうさく 

が応 0S 

SX  3.0 化と 

収録 1 巧を 

バイナリ のみ 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で、 民 oland  SC-55mkII の パッチ パラメータを エディ ッ ト する 
ための プログラム。 

備考 

ZMUSIC.X  ver. 2.00 じ 1  上、 または  RCD.X  verS.Ol じ LI: が必 嬰。 
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N0.17 

SXCalc . X 

分類 

¥APL¥SXCALC 

作者 名 

カ ップ めん 

対応 0S 

SX  3.0 の Ji 

収錄 内容 

別途 詳細 ドキ ュメン トアー カ 
イブ あり。 別途 ソー スフ ァイ 
ル 同 棚 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ウィン ドウの 四々 割 や 節 単な コマン ドマ クロを 実装した、 SX-WIND0W 上の 
EXCEL 風の 表 計算 プロ グラム。 

備を 

SYLK 形式、 CSV お 式、 タブ テキスト 形式の 読み込みが 可能。 シュア ウュア 化 800 
円)。 

N0.18 

DBCtr . X 

分類 

¥APL¥SXDB 

作者 名 

けい 太 

対応 OS 

SX  3.0  U 上 

収録 内容 

バイナリ のみ 

サ ポー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 動作す る dBASE 狸 デー タべー ス。 

N0.19 

sxme 虹 〇 . X 

分類 

¥APL¥SXMEMO 

作者 名 

GRANADA 

対応 OS 

SX  1.1  U  上 

収録 内容 

別途 ソースファイル 1 巧拙 

サポート ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で ポス ト イット 感 党で 使え る ノート アクセサリ。 

No.20 

負荷 計測 SX.X 

か 類 

¥APL¥SXPM 

作者 名 

VSYNC 

が応 OS 

SX  1.1 化 h 

収錄 内容 

バイナリ のみ 

サポート ネット 

Network- SX  NG 

紹介 

負荷 計測 SX.X が 起動され た 時点での MPU を 荷 （1 秒 間に 何回 アイ ド ルイ ベン 
卜が 通知され る 力、） を 剖 •測し、 それを ワーク ステ ー シヨ ン 風に 表示す る プログラム。 

N0.21 

小 時計. r/ 極小 時計. r/ トヶ 
イ .r/CLK.r/CK.r 

分類 

¥APL¥SXTOKEI 

作者 名 

PRAY 

対応 OS 

SX  3.1 

収録 内容 

ソースファイル 同 拙 

サポート ネット 

Network-SX  NG 

紹介 

メモリ 使用 趣の 少ない （0.6K バイト〜 1K バイト 強） 各 穂の 時計の 詰め合わせ セッ 

k 

N0.22 

とけい .x 

II か 類 

1  ¥APL¥TOKEI 

作者 名 

Zeek 

が応 OS 

SX  2.0  U 上 

II 収録 内容 

1 バイナリ のみ 

サポート ネット 

NIFTY-Serve 

紹介 

30 分 ごとの 1 ホ 報、 アラー ム 機能、 指を された 1:1 時に 指を プログラムの 制御が 斤え 
るな ど、 高機能な 鳩が 計 プログラム。 

174 


APPENDIX  C  SX— WINDOW 巧 旅フリ ーソフ ト ー K 


No.23 

xtarante .X 

分類 

¥APL¥XTRANTE 

作者 名 

T.A.N， Natchsoft (なつち） 

が応 OS 

SX  3.1 

収録 内‘ 挣 

別途 オン ライ ン ヘル プア ー々 
イ ブ あり 

サポート ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で 動作す る Excel ライク な 表 計算 ソフト。 

備考 

メインメモリ 4M バイ トじ 1 上必 嬰。 

N0.24 

Zeitor .X 

分類 

¥AP  し  ¥ZEIT0 民 

作者 名 

仁 泉大輔 

が応 0S 

SX  3.0 じ [上 

収録 内容 

別途 ソースファイル 同栖 

サポート ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 動作す る、 べク トル フォントの CAD プログラム。 

N0.25 

SXgZlD .X 

分類  ¥ARC¥SXGZIP 

作者 名 

BAA 

対応 OS 

SX  3.1 

収録 内容  バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG 

紹介 

フ ァイ ル 圧縮 プログラム GNU  zip  ver.1.2.4 の SX— WINDOW 版。 コマンド ライ 
ン モード、 ウィンドウ モー ド、 サー バモー ドの 3 種類が ある プログラム。 

縮考 

ViSON.x  (Niggle 氏 作)、 SXXX  •  X  ( 解; ま SX  : もけ もけ 氏 作） で 使って いる クライ 
アン ト ーサ ー バ 型の イ ンタ ー フエ ー ス をサポ ー ト。 

N0.26 

sxt 辽 r . X 

分類  ¥ARC¥SXTAR 

作者 名 

Niggle 

列 •応 0S 

SX  3.0 の [上 

収録 内を  ソースファイル 同 棚 

サポート ネット 

Network-SX  NG 

紹介 

解凍 SX  (もけ も け 氏 作） の イン ター フユー ス を使っ た 解凍 尊 用の TapeArchiver。 

備を 

サー バモー ドし かないた め、 ViSON.x  (Niggle 巧; 作） と 組み合わせて 使用し なけれ 
ばなら ない。 

N0.27 

SXXX.X 

分類 

¥ARC¥SXXX 

作者 名 

もけ もけ 

が応 0S 

SX  3.1 

収録 1 巧容 

バイナリ のみ 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

高 庙縮書 摩 管理 プロ グラム LHa.X  ((.EXE) 吉崎 栄樂巧 作） で 圧縮され たフ アイ ル 
(Ihd,  IhO,  Ihl, 111 4, lh5, lh6 形ぶ） を SX-WINDOW 上で 解凍す る プログラム。 

N0.28 

ViSON.x 

分類 

¥ARC¥VIS0N 

作者 名 

Niggle 

が応 OS 

SX  3.1  II 収 錄巧容  1 ソース ファイル 同が 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX シ卫 ル 上で アーカイブ 中の ファイルを 参照 する ことができる プログラム。 di.r 
(SX-WINDOW の 内部 コマン ド） の 操作 性を 継を、 お 張した もの。 

備考‘ 

LZH ファイルと tar ファイル、 gzip フ ァイ ルに が応 可能。 
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No.29 

トランプ .LB 

分類 

排 ATA¥CA 民 D 

作者 名 

ASO 

が応 OS 

SX  3.0 社 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 使 うこと がで きる トランプ カードフ リーリ ソース デー タ。 卜 
ランプ カー ド デー タを 使った アプリケーション 刚猪 時の 手 問を 省く ことができる。 

No.30 

麻雀 牌 mini  .LB 

分類 

¥DATA¥PAIMIN 

作者 名 

結 城 あすか 

対応 OS 

SX  1.1  U 上 

収録 内容 

バイナリ のみ 

サ ポー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 使える がが 牌フ リーリ ソース デー タ 麻雀 牌. LB の 縮小 版。 

N0.31 

麻雀 牌. LB 

分類 

¥DATA¥PAISTD 

作者 名 

結 城 あすか 

が応 OS 

SX  1.1 り J 二 

収録 内が 

バイナリ のみ 

サポート ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 使える 麻 旅 牌 フリーり ソース データ。 麻雀 牌を 使った アプリ 
ヶー シヨ ン 開発 時の 牌 データ 作 化の 守-問を 省く ことができる。 

N0.32 

SX.logo .pan 

か 類 

¥DATA¥SXLOGO 

作者 名 

Ryu! 

が応 OS 

SX  3.1 

収錄 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SxPANIC.r  (訊 o-Ta 氏 作） のた めの panic データの スク りー ン セーハ •サンプル。 

備考 

SxPANIC.r  (Sho-Ta  巧 作）、 SAdjust  .r  (Sho-Ta  巧 作） が 必要。 

N0.33 

UN0.LB 

分類 

¥DATA¥UN0 

作者 名 

B-Head 

対応 0S 

SX  1.1 社 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 使える々ー ド ゲーム 「UNO」 用フ リーリ ソース データ。 「UNO」 
の々 ー ド データを 使った アプリ ケー シヨ ン開発 時の 手間を 街く ことができる。 

N0.34 

目玉 .x 

分類  ¥DESKTOP¥EYE 

作者 名 

はば しん 

利 •応 0S 

SX  2.01  U 上 

収録 内が  ソースファイル 問 欄 

サポ ー ト ネット 

Network-SX  NG 

紹介 

同 玉と サイズ ボックス U 外の 部分が 透けて 見える、 オリジナルの WDEF リソース 
を 用 恵した、 いわず と 知れた xeyes け！ 玉） もどき。 

N0.35 

MISA.X  II  分類  1  ¥DESKTOP¥MISA 

作者 お 

Ussy 

列 •応 OS 

SX 1.1 u 上  II 収録の 容 

ソースファイル お] 拙 

サ ポー ト ネット 

Network-SX  NG 

紹介 

NIFTY-Serve の FGALAV にな 録 されて いる アニメー シヨ ン幽像 デー タ 「来沙 
ちゃん」 シリー ズの MS-Windows  3.0 版 「美 砂 ちゃん」 を 移植した もの。 1 則而の 
隅に おいて おけば 幸せに なれる かも。 
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No.36 

SeSS.x 

分類 

¥DESKTOP¥SESS 

作者 名 

特 a 級 電脳 師 

対応 OS 

SX  3.0 じ [上 

収録 巧を 

ソースファイル 同 棚 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW の アプリ ヶー ショ ンの 起動 •終了を コント ロー ルして スク リーン 
セー ハ •のよう にみ せる プログラム。 

N0.37 

X-logo.SMD,  Life.SMD, 
Swarm. SMD 

か 類 

¥DESKTOP¥SXMODULE 

作者 名 

An 

対応 OS 

SX  3.0 肚 

収録 内容 

ソースファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW デスク アクセサリ 集 対応の スク リーン セー バ モジ ュール 3 点。 

N0.38 

ar  丄 k .  X 

分類 

¥DEVE し OP¥A 反し K 

作者 名 

けんと 

が応 0S 

SX  3.1  /  Human68k 

収録 内容 

ソースファイル 同 欄 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX シュル 上から 呼び 化す ことが 可能な 高機能 リ ソース リ ンカ プログラム。 シャー 
プ 純正 rlk.x とは 非 互換。 

N0.39 

CCCV .X 

分類 

¥DEVELOP¥CCCV 

作者 名 

BLACK. 

対応 OS 

Human68k 

収錄 内容 

ソースファイル 同 棚 

サ ポー ト ネット 

Network-SX  NG 

紹介 

CCV.X によ り 変換され た コー 1 

ドリ ソースを 元の.: 

X ファイルに 戻す ツール。 

備考 

シン ボル 情報に ついては 完全に 樓元 する こ とはで きない。 

No.40 

cplk.x 

分類 

¥DEVELOP¥CPLK 

作者 名 

Dangerous  Driver  ZNT 

対応 0S 

Human68k 

収録 内容 

別途 ソースファイル 同地 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW が応の 動画 フ アイ ル (CGA 形式） の ADPCM データを 追加、 交換、 抽 
化する プログラム。 

N0.41 

Ivcv.x,  IvcvO づ 0.X 

分類 

¥DEVELOP¥LVCV 

作者 名 

Dangerous  Driver  ZNT 

対応 0S 

Human68k 

収錄 内容 

別途 ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG 

紹介 

CZ-6VS1 (々ラー イ メージ ユニット 2) 付属の ライブ スキャン .X  (SX-WINDOW 
上で 動作） が 化ん する •  LV 形式の 動邮フ ァイ ルを、 SX- WINDOW の. GLM おぶ で 
コ マ 別に 化ソ J する プログラム。 CGA データ の 作成 にも 使える。 

備考 

gcc の- m 68040 オプ シヨ ン村 •きで 作成され た X68030 化 li 専用の lvcv030.x を 
同 欄。 
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No.42 

MenuDesig 凸 er .X 

分類 

¥DEVELOP¥MENUDESI 

作者 名 

仁 泉大輔 

が応 OS 

SX  3.0 じ [上 

収録 内容 

ソースファイル 同 拙 

サポート ネット 

NIFTY-Serve 

紹介 

SX-WINDOW のメニ ューリ ソース MENU を 編集す るた めの プログラム。 

N0.43 

rscv.x 

分類 

¥DEVELOP¥RSCV 

作者 名 

JunT 

が応 OS 

HumanSSk 

収録の 容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW で 用いられ るり ソースの 内容を 16 進 ダンプしたり、 PAT4 などの 
ハ。 ターンり ソース なら ば 画面に 表示す る ことができる プログラム。 

No.44 

SXREF.DIF,  SXREF.TXT 

分類 

¥DOC¥INSIDE 

作者 名 

亚山 雪 

対応 OS 

SX  2.0 社 

収録 内容 

差分の み 

サポート ネット 

NIFTY-Serve 

紹介 

イン サイド SX.X  (開発 ドキュメント 用 ッール 集に 同 欄） にが 応 した、 SX アプリ 
を 開発す るのに 便利な オ ン ライン ドキュメント。 

備考 

イ ン サイド SX.X が 必要。 

N0.45 

VMINSTALL.PEN 

分類 

¥DOC¥VMINST 

作者 名 

BLACK. 

が応 OS 

SX 义 1 

収録 内を 

ドキ ュメン ト 内に サンプル ソー 
スフ アイ ル あり 

サポート ネット 

Network-SX  NG 

紹介 

IVM 用の ビデオ マネー ジャリ ソース (VMZAU,  VMCUT など） の インス トー ルス クリ 
プト じ閒 する サンプル ドキュメント。 

備考 

コンパイルす るた めには 削 発キッ トツー ル 集と XC が 必要。 

N0.46 

マップ エディタ .X 

分類 

¥EDITOR¥MAPEDIT 

作者 名 

CHIHI 

が応 OS 

SX  3.1 

収錄 内容 

バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で 動作す る BG マッ プ エディタ。 

N0.47 

xemacs .  x^,mule) 

分類 

¥EDITOR¥MULE 

作者 名 

BAA 

対応 OS 

SX  3.1  /  Human68k  | 

1 収錄 内容 

1 ソースファイル 同 削 

サポート ネット 

Network-SX  NG 

紹介 

廚 機能 •々スタ マイ ズ 可能な エディタ Mule-U.04 の SX-WINDOW  /  Human68k 
共用 版。 
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No.48 

nemacs .X 

分類 

排 DITO 民  ¥NEMACS 

作者 名 

沖 @ 沖 

対応 OS 

SX  2.0 む上 

収録 1 巧容 

バイナリ のみ 

サ ポー ト ネット 

Network- SX  NG/NIFTY-Serve 

紹介 

高機能. 々スタ マイ ズ 可能な エディ タ である GNU  Emacs の 日本語 版 Nemacs 
义义 2 の SX-WINDOW 版。 

備考 

1M バイト じ 1 上の空き メモリ が 必要。 

No.49 

ng.x 

分類 

乳 DITO 民  ¥SXNG 

作者 名 

沖 @ 沖 

が応 OS 

SX  2.0 社 

収録 内容 

バイナリ のみ 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX-WINDOW  上で 動作す る 日本語  micro  GNU  Emacs、 Ng  1.3.1 。 

No.50 

2 行 じす るの. て 

分類 

¥EXT¥2LINE 

作者 名 

けんと 

対応 OS 

SX  3.01/3.1 

収録 内容 

ソース ファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

長い ファ イ ル 名を 2 斤に 巧り 返して 表示す る こと がで き る プログラム。 

備考 

adi.r、 アイコン 間隔 .r  (けんと 氏 作） と 組み合わせ ると 最高。 

N0.51 

Active Jmp.X 

分類 

乳 XT¥ACTJP 

作者 名 

PRAY 

が応 OS 

SX  3.1 

収録 内容 

ソース ファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG 

紹介 

アク ティ ブ になった ウィン ドウが 画面 内に 収まって いない、 あるいは 画面 内 じない 
場合、 ウィン ドウ 全面が 収まる よう 最小限の スクロールを 自動的に 斤う プロ グラ 
ム〇 

備考 

Winselect  .X  (T.A.N 氏 作） と 組み合わせる と 最高。 

N0.52 

adi.r 

分類  ¥EXT¥ADI 

作者 名 

けんと 

対応 OS 

SX  3.01/3.1 のみ 

収録 内容  別途 ソー スフ アイ ル同捆 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

1) アクティブ でない とき も ポップアップ メニ ューを 出す、 2) ウィン ドウを 開いた 
ときに アイ コンを 整頓す る、 3) 沖 @ 沖 氏の Indrv の ディ レクト リリ ンク にが 応、 
4)DIRDT0P.SX を 作る パスを 指定す るな ど、 111 頁 目に わたり di.r を 拡張した シ 
ス テム プログラム。 

備考 

アイコン 間隔 •！•、 2 行 じする の .r  (いずれも けんと 氏 作） と 組み合わせ ると 最 
窩。 BUILTIN.LB に 組み込む イ ンス トール バッチ プログラム 付き。 

N0.53 

Beep Changer .X 

1 分類 

1  ¥EXT¥BEEPCHG 

作者 名 

MAPI (小 野 塚 正則） 

が応 OS 

SX  2.0 じ [上 

収録のを 

1 バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介’ 

SX-WINDOW の 「ピン ポー 

ン」 という BEEP 音を 変更す るた めの プログラム。 
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N0.54 

eg. bid 

分類 

排 XT¥CGBFD 

作者 名 

沖 @ 沖 

対応 OS 

SX  3.0  U 上 

収録 内容 

バイナリ のみ 

サポート ネット 

Network- SX  NG 

紹介 

キャンバス .X と CG ビジョン .X のメニ ューを ClickMemi (沖が 中 氏 作） と 同祿、 
マウスの クリ ックで ON/OFF できる ようにす るた めの プログラム。 

N0.55 

ClickMenu.x 

分類 

¥EXT¥CLICK 

作者 名 

沖 @ 沖 

が応 0S 

SX  2.0 社 

収録の 容 

バイナリ のみ 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ポ ップ アップ メニ ューを マウスの クリックで ON/OFF できる ようにす る ための プ 
ログ ラム。 

備考 

階層 化 メニュ ー.X に 同等の 機能 あり。 

N0.56 

地上げ屋 .X 

分類 

¥EXT¥DIAGE 

作者 名 

もけ もけ 

対応 0S 

SX  3.0 の 

収録 内容 

バイナリ のみ 

サポート ネット 

NIFTY-Serve 

紹介 

「プログラミング 専用」 「音楽 観赏專 用」 のよう じ、 5 つの デスクトップを 設定す 
る ことができる プログラム。 

N0.57 

e-c- brace . ex/isearch. 
ex/optab. ex/rpar . ex/ 
setkindl . ex/xclick . ex 

分類 

都 XT 排 XC 

作者 名 

けんと 

が応 0S 

SX  3.1 

収録 内容 

ソースファイル 同 刪 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

インク リメ ン タルサー チ 等を 可能に する、 シャー ペン .X の 外部 コマンド。 

備考 

SX-WINDOW  ver.3.1 か厲の シャー ペン .X が 必要。 詳しくは 「0h!X」 1994 年 
10 巧 号を 参照。 

N0.58 

ext drag . r 

分類 

¥EXT¥EXTDRAG 

作者 名 

KUM 

列 •応 0S 

SX  3.0 じ 1 上 

収録 1 巧容 

ソースファイル 同 棚 

サ ポー ト ネット 

Network-SX  NG 

紹介 

extdrag.r  (Niggle 氏 作 ViSDN じ 同 欄 の ソース ファイル をな 造した、 GARBAGE. X 
と 併用が の 不具合を 取り 除く プロ グラム。 

N0.59 

ファイル 名 補完 .X  1 

分類 

1  ¥EXT¥FCMPL 

作者 名 

Yoz. 

が応 OS 

SX  1.1 社  1 

1 収録 内を 

1 バイナリ のみ 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX-WINDOW の テキスト エディット 上 （ファイル 名を 入力す る 疑似 ダイア ロ グ 等） 
で ファイル 名の 補完を 可能 じする プログラム。 
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No.60 

f ix_mv.r 

分類 

¥EXT¥FIXMV 

作者 名 

けんと 

対応 OS 

SX  3.1 

収録 1 勺容 

ソースファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

subst  •  x や mount .  x で 複数の ドライ ブを 単ー ドライ ブに まとめた ときの、 SX- 
WINDOW  上での 不都合を 解消す る プロ グラム。 

N0.61 

HCDAD.SYS 

分類 

¥EXT¥HCDAD 

作者 名 

PRAY 

ネホ応 0S 

Human68k 

収録 内容 

ソースファイル 同洒 

サ ポー ト ネット 

Network-SX  NG 

紹介 

連奏 タイプの CD-ROM ユニット の 指を LUN 番号を 無 巧す る ことにより、 CD- 
民 0M ユニッ トの 起動時 閒を 短縮す る プログラム。 

備考 

cddev.sys  (計測 技研 製 CD-ROM デバイス ドライバ） よ リ 先に 登録す る 必要が 
ある。 

N0.62 

henwin2 . x 

分類 

¥EXT¥HENWIN2 

作者 名 

Niggle 

列 ■応 0S 

SX  3.1 

収緑 内容 

NeXTl ike- Window  用の リ 
ソース 同 棚 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ASK  (FEP) の変檢 ウィンドウの 位篇、 サイズ、 フォント サイズ （12/16 ドット） を 
変更す る ことができる プログラム。 

備考 

ASK 導 用 高速 化 モー ドを 使用す ると 不具合 あり。 

N0.63 

アイコ ン 間隔 .r 

分類  ¥EXT¥IWIDTH 

作者 名 

けんと 

対応 0S 

SX  3.01  U 上 

収録 内容  バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

di.r などで アイコンが 並べられる 閒隔 （縦横 80 ドット） を 任意の 値に 調整す るプ 
ログ ラム。 

備考 

adi.r、 2 行 じす るの. て (けんと 氏 作） と 組み合わせる と 最高。 

No.64 

階 雇 化 メニュ ー.X 

分類 

¥  丘  XT¥KAIS0 

作者 名 

CHIHI 

対応 0S 

SX  3.1 

収録 内容 

ソースファイル 同釉 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX-WINDOW のメ ニュー マネージャを、 シェル メニューの 階府 化、 表示 文字列 
の マルチ フォント 化、 PAT4 イメ ージの 貼り付け など、 81  頁 目に わたって 機能 強化 
する プログラム。 

N0.65 

SXperiod.x 

1 分類 

¥EXT¥MPERI 

作者 名 

あ 一る もー リあ 

対応 0S 

SX  3.1  /  Human68k 

II 収録 1 巧容 

1 ソース ファイル 同 拙 

サ ポー ト ネット 

NIFTY- Serve 

紹介 

SX-WINDOW を マルチ ピリオドに 対応させる ための 常駐 プログラム。 
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N0.66 

SAdiust .r 

分類 

排 XT¥SADJUST 

作者 名 

Sho— Ta 

対応 OS 

SX  3.1 

収録 内容 

バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

ADJUST,  r  (SX-WINDOW 内部 コマンド） を 使わずに、 SX-WINDOW の 実 画面 
を 巧 意 サイズに 設定す る プログラム。 

備考 

CRTCTRL.r  (Sho-Ta 氏 作） と いっしょに 利用す る ことにより、 マウス オペ レーシヨ 
ンでセ ッ トアッ プ 可能。 SX-BASIC が応。 

N0.67 

setdtop .X 

分類 

¥EXT¥SETDTOP 

作者 名 

Mew 

列 •応 0S 

SX  2.01 じ 1  上 

収録 内容 

バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG 

紹介 

DIRDTOP.SX を 指定 パスに まとめる プログラム。 

N0.68 

SilentActivate . X 

分類 

¥EXT¥SILENT 

作者 名 

CHIHI 

が応 0S 

SX  3.1 

収録 内容 

ソースファイル 同 拙 

サポ ー ト ネット 

Network-SX  NG 

紹介 

奥に 表示され た ウィン ドウを 手前に 並べ 換える ことなく、 アク ティべ ー ト にす るた 
めの プログラム。 

備考 

SX-BASIC が応。 専用 インス トー ラが •属 。コント ロール パネル 追加 設定 可能。 

N0.69 

SNAP04.INS,  SNAP04.LB 

分類 

¥EXT¥SNAP 

作者 名 

An 

が応 0S 

SX  3.1 

収録 内容 

別途 ソースファイル 同栖 

サポート ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で ダイアログを 利用 するとき じ、 マウス カーソルを 「設定」 ま 
たは 「確認」 などの ボタンに 自動的に 移動させる プログラムの インストール スクリ 
プト。 

備考 

インス トー ラ .X が 必要。 コントロール パネルに 追加 設定 可能。 

No.70 

SXerror .X 

分類 

¥EXT¥SXE 民 ROR 

作者 名 

沖が 中 

対応 0S 

SX  2.0 り Ji 

収録 内容 

ソースファイル 同 糊 

サ ポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX-WINDOW 上で バス エラー やア ドレス エラー が 発生した タスクの ID を 表示 
し、 その タスクの みを 強制 終了す る ことができ るよう にす る プログラム。 

N0.71 

SXWS.X 

分類  ¥EXT¥SXWS 

作者 名 

カ ップ めん 

が応 0S 

SX  2.0  U 上  II 収鍊 内容 

別途 ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

デスク トップ 上で つ わじ 壞も 手前に 表示され る、 SX-WINDOW 標準 機能の ペー 
ジ アイ コンと 同じよう な 動作を する プログラム。 
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No.72 

WL 203.1 NS,  WL203.LB 

分類 

¥EXT¥WINLOC 

作者 名 

An 

対応 OS 

SX  3.0 じ [上 

収録 内容 

ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で 新しく 開く ウィン ドウの 位證を 細かく 制御す るた めの インス 
トール スク リ プト。 

備考 

インス トー ラ .X が 必要。 コン トロール パネルに 追加 設を 可能。 

N0.73 

WinSelect .X 

分類 

¥EXT¥WINSEL 

作者 名 

T.A.N 

が応 OS 

SX  3.1 

収録 内容 

バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

キー ボー ドから アクティブ ウィン ドウの 切り替え や ディ レクト リ 表示 ウィン ドウの 
スクロール、 ヒストリ、 タスクの 終了な どを 実行す るた めの プログラム。 

備考 

Active  Jmp  .X  (PRAY 氏 作） と 組み合わせる ことじより、 マウス レス オペ レー シヨ 
ンが 可能。 

N0.74 

Workspace .X 

分類  ¥EXT¥W0 民  KSPC 

作者 名 

T-A-N 

対応 0S 

SX  3.1 

収録 内容  バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG 

紹介 

6 個の 仮想 デスク ト ップ （ワーク スペース） を 提供す る プログラム。 

備考 

管理で きる ウィン ドウは 最大 64 まで。 

N0.75 

aisk.inf O.X 

分類 

¥FILE¥DINFO 

作者 名 

ウイル 

対応 0S 

SX  3.0 じ [上 

収録 内容 

別途 ソースファイル 同 欄 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

高密度な 情報 表示 を 行う ことができる、 dinf 〇 •  r  (SX-WINDOW の 内部 コマン 
ド） の 上位 互換 プログラム。 

N0.76 

DRVINF0 . R 

分類  ¥FILE¥DRVINFO 

作者 名 

VSYNC 

刘 ■応 OS 

SX  3.1 

収録 内容  バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

指定 ドライブの 容 盘 変化を リアルタイム 表示したり、 容量 使用 率を 円グラフで 表 
示す るな ど、 高密度な 情報 表示を 斤う dinfo.r  (SX-WINDOW の 内部 コマンド） 
の 上位 互換 プログラム。 

備考 

BUILTIN.LB じ 登録す る 方法 も 記載。 

N0.77 

FILEINF0 .  X  II  分類  1  ¥FILE¥FILEINFO 

作者 名 

VSYNC 

対応 OS 

SX  3.1 

収録 内容  ハ •イナり のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

ファイルの パスを スクラップへ コ ピーしたり、 横 数 ファイルの ファイル 属性を まと 
めて 変更したり、 複数 ファイルの 容凰 表示を したりす るな ど、 高密度な 情報 表示を 
行う info.r  (SX-WINDOW の 内部 コマンド） の 上位 互換 プログラム。 

備考 

BUILTIN.LB に 登録す る 方法 も 記 戦。 
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No.78 

file-info.x 

分類 

¥FILE¥FINFO 

作者 名 

ウイ ノレ 

が応 OS 

SX  3.0 化と 

収録 内容 

別途 ソースファイル 同捆 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

ファイルの 実行 属性、 リンク 属性の 表示 •設定 や、 フルパス 名の クリップ ボード 転 
送な どを 巧う ことができる、 info.r  (SX-WINDOW の 内部 コマン ド） の 上位 互 
换 プログラム。 

N0.79 

f 皿 emo . X 

分類 

¥FILE¥FMEMO 

作者 名 

ウイル 

が応 0S 

SX  3.0  U 上 

収鍊 内を 

別途 ソースファイル 同 欄 

サポート ネット 

NIFTY-Serve 

紹介 

file-info .xf ウィル 氏 作） と 組み合わせる ことにより、 ファイル ごとに メモ 書き 
機能を 持たせる ことができる プログラム。 

No.80 

SXINF0.R 

分類 

¥FILE¥SXINFO 

作者 名 

VSYNC 

が応 OS 

SX 义 1 

収録 内を 

バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

現在の SX-WINDOW の 空き メモリ 容量 や 1 秒 あたりに タスクに 通知され る アイ 
ドル イベント 数、 現在 年 巧 日、 現を 時刻を 表示したり、 メモリの 再配置を 斤う シス 
テム 表示 プログラム。 

N0.81 

gnuchess . X 

分類 

¥GAME¥GNUCHESS 

作者 名 

Yoz. 

が応 0S 

SX  2.0  iU 上 

収錄 内を 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG/ NIFTY-Serve 

紹介 

人間 と コン ピュ ータ がが 戦す る こと も、 コン ピュ ータ 同-上で が 戦す る こと もで きる 
チェス ゲーム GNU  CHESS の SX-WINDOW 版。 

N0.82 

MKCS.X 

分類  ¥GAM 巨 ¥GO し FEDIT 

作者 名 

T.KAZBON 

が応 0S 

SX  2.0  U 上 

収録 内容  バイナリ のみ 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SxGOLF.X  (T.KAZBON 氏 作） の コース データを 作成す るた めの プログラム。 

備考 

16 を モー ドが のみ 動作 可能。 

N0.83 

G0LFSW. PCM, CASTA . PCM, 
CUP- IN .PCM, 

SPRING. PCM, 

SPLASH. PCM,  APL.PCM 

み 類 

¥GAME¥GOLFPCM 

作者 名 

T.KAZBON 

が応 OS 

SX  2.0 じ 1  上  1 

1 収録 内容  1 

バイナリ のみ 

サポート ネット 

NIFTY-Serve 

紹介 

SxGOLF.X  (T.KAZBON 氏 作） 用の ロイ ヤリ ティ フリーの ADPCM デー タ。 

備考 

リソ ースリ ン 々等が 必要。 
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No.84 

SX-PITMAN.X 

分類  ¥GAME¥PITMAN 

作者 名 

MAPI  (小 野 嫁 正則） 

が応 OS 

SX 1.1 化と 

収録 内を  バイナリ のみ 

サポート ネット 

Network- SX  NG 

紹介 

電脳 俱楽部 Vol.16 じ 掲載され た PITMAN の SX- WINDOW 版。 

N0.85 

SX-Sirtet .X 

分類 

¥GAME¥SIRTET 

作者 名 

MAPI  (小 賢 塚 正則） 

が応 0S 

SX  1.1 の Ji 

収録 内を 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で 動作す る、 4 穗 類の タイル からなる ブロックを 横 1 列 に 並べ 
て 同種の タイルを 消して いく  「テトリス」 ライクな ゲーム。 

N0.86 

SX 青’; 毎 .X 

分類 

¥GAME¥SXCHN 

作者 名 

結 城 あすか 

が応 0S 

SX  1.1  u  上 

収録 内容 

バイナリ のみ 

サポート ネット 

NIFTY-Serve 

紹介 

麻雀 牌を 使った パズル ゲーム。 

備-夸 

麻雀 牌フ リーリ ソース デー タ 麻雀 牌 .LB、 
氏 作） のい ずれ かが 必要。 

麻雀 牌 田 ini. LB  (いずれも 結 城 あすか 

N0.87 

SxGOLF.X 

分類 

¥GAME¥SXGOLF 

作者 名 

T.KAZBON 

対応 0S 

SX  2.0 じ [上 

収録 内容 

別途 ソースファイル 同 棚 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上の ゴルフ ゲ ーム。 4 人まで 参加で き、 マッチ プ レイモー ド （VS. 
X68000) を 楽しんだり、 スライス や バックスピンを かけたり する こと が 可能。 

備考 

SX-WINDOW  ver.3.0 じ [上では 16 色 モー ド 時の み 動作 可能。 

N0.88 

SX 香港 .X 

分類 

¥GAME¥SXHONG 

作者 名 

う め吉 

が応 0S 

SX  2.01 り 1  上 

収録 内容 

バイナリ のみ 

サ ポー ト ネット 

NIFTY-Serve 

紹介 

麻雀 牌を 使った パズル ゲーム。 

備考 

麻雀 牌フ リーリ ソース デー タ 麻雀 牌 .LB、 麻雀 牌 mini.LB  (いずれも 結 城 あすか 
氏 作） のい ずれ かが 必要。 

N0.89 

SXB0MB . x/SX2DMaze . x/ 

SXSDMaze . x 

分類 

¥GAME¥SXJUNKS 

作者 名 

yana 

列 ■応 OS 

SX  2.0 じ 1  上  1 

1 収録 内を  1 

1 バイナリ のみ 

サポート ネット 

NIFTY-Serve 

紹介 

爆弾を 探す パズル ゲーム （S 拙 OMB.X)、 2D 迷路の オート デモ （SX2DMaze.x)、 3D 
ダン ジョ ン風 迷路 （SXSDMaze.x) の 3 つの プログラム。 
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No.90 

SX クロ ン ダイク .x 

分類 

¥GAME¥SXKRON 

作者 名 

Dust 

が応 OS 

SX  2.01 り Ji 

収錄 内容 

別途 ソースファイル 同捆 

サポ ー ト ネット 

Network- SX  NG 

紹介 

MS-Windows  ver.3 付属の々ー ド ゲーム 「ソ リ ティア」 の SX-WINDOW 版。 

備考 

トランプ カードフ リーり ソース データ、 トランプ . LB  (ASO 氏倘 が 必要。 

N0.91 

マイ ン スイーパ .X 

分類 

¥GAME¥SXMIN 

作者 名 

An 

が応 0S 

SX  2.0 じ [上 

収録 内容 

別途 ソース ファイル 同栖 

サポート ネット 

Network-SX  NG 

紹介 

MS-Windows 等で おなじみの 隱 された 爆弾を 探す パズル ゲ ーム、 マイ ンス イー パ 
の  SX-WINDOW  版。 

N0.92 

SX-Tatris .X 

々類  ¥GAME¥TATRIS 

作者 名 

MAPI  (小 野 塚 正則） 

ネホ応 OS 

SX  1.1  u  上 

収録 内容  バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

Ko-Window 上で 動く 「Tatrisj 卜 化 を 風靡した 「コラ ムス j と 同じ ルー ルの 
ゲ ーム） の SX-WINDOW 版。 

N0.93 

G.atelier .X 

み 類 

¥GRAPH¥GATELIER 

作者 名 

GOMO 

が応 0S 

SX  3.0 じ 1 上 

収録 巧を 

別途 ソースファイル 同栖 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

JPEG 形式の 高速 口ー ダを 内蔵した グラフィック エディタ。 

備考 

65 が 6 色 モー ドで IVM.X が 常駐して いる こと。 

N0.94 

GLMpatch. X 

分類 

¥GRAPH¥GLMPAT 

作者 名 

BLACK. 

が応 0S 

SX  3.1 

収録 内容 

ソース ファイル 同栖 . 

サポ ー ト ネット 

Network-SX  NG 

紹介 

IVM.LB  (1994/05/30  12:00 赋 に 登録され ている、 GLM リ ソースで 512x512 ドッ 
卜 を 超える 画像が 扱えない 不具合を 修正す る プログラム。 

備考 

実質的な 画像 サイズの 制限は 搭載 メモリ による。 

N0.95 

grroot .X 

か 類 

¥G  民  APH¥G  民  ROOT 

作者 名 

An 

対応 OS 

SX  3.0 じ 1  上  1 

1 収録 内容  1 

1 ソースファイル 同 拙 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW の デスク トップの 壁紙を 8192 倍 （従来 上ヒ） 派手に する ための プロ 
グラム。 

備考 

あらかじめ 画面 モー ドを 65,5% 色 モードに 設定し、 ビデオ マネー ジャ （IVM.X， 
IVM.LB) を 常駐 させ、 さらに コントロール パネルの 背景 設定で 「ユー ザー」 が 選 
択 されて いる 必要が ある。 
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No.96 

gr.sel .X 

分類 

¥G 民 APH¥GRSE  し 

作を 名 

かご や 

ネホ応 OS 

SX  3.1 

収録 内容 

ソースファイル 同 欄 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ビデオ マネージャ (IVM.X,  IVM.LB) でサ ポート されて いる 關像 ファイルを、 
grroot  .X を 使って ランダム (こ 壁紙と して 設定す る プログラム。 

脯考 

grroot  .X  ver.1.11  U 上 （An  氏 作） が 必要。 

N0.97 

壁紙 動画 .r 

分類 

¥GRAPH¥HEKIDO 

作者 名 

Sho-Ta 

ザ応 0S 

SX  3.1 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW の 壁紙 上で ス クロール 機能の みを 使った アニメーション （書き換え 
なし） を 行う プログラム。 

備考 

SX-BASIC ず ホ応。 chadance.pic は 含まれて いません。 

N0.98 

壁 動 玉々 .r 

分類 

¥G  民  AP 牌 HEKITM 

作者 名 

Sho-Ta 

対応 0S 

SX  3.1 

収録 内容 

バイ ナリ のみ 

サ ポー ト ネット 

Network-SX  NG 

紹介 

壁紙 動画 .r  (Sho-Ta 氏 作） を 利用 して、 SX-WINDOW の 壁紙 上で 多数の 青い 玉 

の アニメ ー シヨ ンを 行う プログラム。 

N0.99 

vmii— 面  ag.r , 
vmec-mag .  r 

分類 

¥GRAPH¥IVMAG 

作者 名 

Amalin 

が応 0S 

SX  3.1 

収録 巧を 

ノ 、•イナり のみ 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ビデオ マネー ジャ （IVM.X,  IVM.LB) に 追加 登録して、 館 CG ファイル 形式 （拡張 
子 .MAG、 まき ちゃん CG ファイル 形式 .MKI の 改良 版の ファイル） を 表示す るた 
めの イ ンス トール スク リ プト。 

備-考 

オリ ジナ ルイ ンス トー ラに よ リイ ンス トー ル。 MAG 形式の セー ブは 不可。 

No.lOO 

皿 aki if.r,  maki.ec.r 

分類 

¥GRAPH¥IVMAKI 

作者 名 

Amalin, 西 橋 

が応 0S 

SX  3.1 

収録 内容 

バイナリ のみ 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ビデオ マネー ジャ (IVM.X,  IVM.LB) じ 追加 登録して、 まき ちゃん CG ファイル お 
式 服 張子 .MKI:  MAKIchan  Graphic の 略。 鲍 BBS  (旧 まき ちゃん ネット） で 開 
発された 化用刚 像 フォー マット） の ファイルを 読み書き する ための イ ンス トー ルス 
ク リ プト。 

備考 

オリ ジナ ルイ ンス トー ラに より インスト ー ル。 
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No.lOl 

PiVM.X 

分類 

¥GRAPH¥PIVM 

作者 名 

けんと 

対応 OS 

SX  3.0 化と 

収緑 内容 

バイナリ のみ 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

スター ト アップ メンテ .X に 登録す る ことにより、 Pi 形式の 晒 像を キャンバス .X 
や が root  •  X  (An 氏 作） などで 扱う ことができる ようにす る プログラム。 

備考 

IVM.LB じイ ンス トー ルす る こと も 可能。 

No.102 

SxPANIC.r  1 

夕颁  ¥G 民 AP 照 SXPAN に 

作者 お 

Sho-Ta 

が応 OS 

SX  3.1 

収録 内容  バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上から、 PANIC .x! ぱ こたん 氏 作） によって 表示され る panic デー 
夕 （アニメー シ ヨン） を 楽しむ ための プログラム。 

備考‘ 

画面 復帰には SAdjust.r  (Sho-Ta 氏 作） が 必要。 

No.103 

SXPIconv.x 

み 類 

¥G  民  APH¥SXPK：ONV 

作者 名 

BLACK. 

が応 OS 

SX  2.0 社 

収録 内を 

ソースファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG 

紹介 

PIX 形式の 圃像 ファイルと 圧縮効率の よい Pi 形式 （やなぎ さわ 氏 作） の 画像 ファ 
イ ルとの 間で 相互に デー タを コン バート する プログラム。 

備考 

ビデオ マネー ジャ (IVM.X,  IVM.LB) に 追加 登録す る Pi リ ソース （けんと 氏 作） も 
あり。 

No.104 

SXpiXDl .X 

分類  ¥GRAPH¥SXPIXPI 

作者 お 

BLACK. 

が応 OS 

SX  3.0/3.1 

収録 内を  ソースファイル 同 棚 

サポート ネット 

Network-SX  NG 

紹介 

65,536 色モー ド 時に、 GRW.X を 利用して PIX,  Pi 形式の 画像を 表示す るプ ログ ラ 

ム。 

備考 

SX-BASIC  が応。 

No.105 

vmcut . INS ,  vmcut . LB 

み 類 

¥G  民  AP 照 VMCUT 

作者 名 

BLACK. 

対応 OS 

SX  3.1 

収録 内容 

ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG 

紹介 

ビデオ マネー ジャ (IVM.X,  IVM.LB) じ 追加 登録して、 CUT ファイル （BEEPs 氏 
作） 形式の ファイルを 読み書き する ための イ ンス トール スク リ プト。 

備考 

インストーラ .X が必 嬰。 

No.106 

VMGIF.INS,  VMGIF.LB 

II 分類 

1  ¥GRAPH¥VMGIF 

作者 名 

KUM 

対応 OS 

SX  3.1 

II 収録 内容 

1 バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

ビデオ マネー ジャ （IVM.X， IVM.LB) に 追加 登録して、 GIF89a じ 準 被した GIF 形 
式の ファイルを 読み書き する ための イ ンス トー ルス ク リ プト。 

備考 

イ ンス トーラ .X が 必要。 
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No.107 

vmp2 . INS ,  vmp2 . LB 

分類 

¥GRAPH¥VMP2 

作者 名 

BLACK. 

対応 OS 

SX  3.1 

収録 内容 

ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG 

紹介 

ビデオ マネージャ (IVM.X,  IVM.LB) に 追加 登録して、 PIC2  (やなぎ さわ 氏 作） お 
式の ファイルを 読み書き する ための インス トール スク リ プト。 

備考 

インス トーラ .X が 必要。 

No.108 

VMIF SC8  VMEC SC8 

分類 

¥GRAPH¥VMSC8 

作者 名 

VSYNC 

対応 0S 

SX  3.1 

収録の 容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

ビデオ マネー ジャ (IVM.X,  IVM.LB) に 追加 登録して、 SC8  (MSX2  U 蜂の SCREENS 
の VRAM イメージを BSAVE フォ ーマッ トで 保な した もの） 形式の ファイルを 読み 
普き する ための コー ドリ ソース バイナリ プログラム。 

備考 

リソース エディタ、 リソース リンカが 必要。 

No.109 

vmzau. INS,  vmzau . LB 

分類 

¥GRAPH¥VMZAU 

作者 名 

BLACK. 

が応 OS 

SX  3.1 

収録 内容 

ソースファイル 同 欄 

サポート ネット 

Network-SX  NG 

紹介 

ビデオ マネージャ （IVM.X,  IVM.LB) に 追加 登録して、 シャープ 製 電子 手帳 ZAURUS 
の 手書き メモ （拡張 子は .ZAU) を 読み書き する ための イ ン ストー ルス ク リ プト。 

備考 

インス トーラ .X が 必要。 

No.llO 

Xbmp . X 

分類  ¥GRAPH¥XBMP 

作者 名 

Ryu! 

が応 0S 

SX  3.1  /  Human68k 

収録 巧を  バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

MS-Windows および OS/2 で 標準 フ オー マットと なって いる 「BMP」 形式 （無 圧 
縮 .BMP.  RLE 圧縮 .RLE、 圃雨 比に 化存 しない もの .DIB) の ファイルの 口ー ダ 
プログラム。 シヤー ペン •  X 上の コン ソー ルからの 呼び 化しに も 対応して いる。 

N0.111 

SXlisD .X 

分類 

¥LANG¥SXLISP 

作者 名 

沖 @ 沖 

対応 0S 

SX  2.0  n± 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 動作す る Lisp インタープリタ。 

N0.112 

iconwdef.r  ||  々類  |  ¥LIB¥ICONWDEF 

作者 名 

HIDORI 

対応 OS 

SX  2.0 じ [上 

収録 内容  1 ソースファイル 同 欄 

サポート ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上での アイコ ン 化を スマー ト に 突 現す るた めの オリ ジナル ウィン 
ドウ 定義 1 划数 (WDEF) プログラム。 

備考 

サンプル プログラム 同 欄。 
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N0.113 

moCDEF . r 

分類 

乳 IB¥MOCDEF 

作者 名 

沖 @  中 

対応 OS 

SX  2.0 社 

収録 内を 

ソースファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

標準 ボタンと 差し替える ことが 可能な、 立体 ボタンの リ ソース プログラム。 

備考 

リソー スリン カ （rlk.x,  rsc.x,  arlk.x など） が 必要。 

N0.114 

picbttn.r 

分類 

¥LIB¥PICBTTN 

作者 お 

HID0RI 

列 •応 0S 

SX  2.0 社 

収録 内容 

ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG 

紹介 

沖 @ 沖 巧 作の moCDEF.r を もと にして picture  button に 特化した オリ ジナル コ 
ント ロー ル 定義 閱数 "picbttn，，。 

備考 

サンプル プログラム 同 拙。 

N0.115 

SXHEL 

分類 

¥LIB¥SXHEL 

作者 名 

PRAY 

が応 0S 

Human68k 

収緑 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

Human68k 用の プログラムを SX-WINDOW に 移植す るた めのへ ッ ダ & ライブ ラ 
リの キット。 

備考 

サンプル ファイル 同 欄。 

N0.116 

TSSLIB  1 

分類 

¥LIB¥TSSLIB 

作者 名 

PRAY 

対応 0S 

Human68k 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

主に アセンブラで "怖 単に’’ 疑似 マルチ タスク プロ グラムを 作成す るた めの ライブ 
ラリ 集。 

N0.117 

updownlib 

分類 

乳 IB¥UPD0WN 

作者 名 

けんと 

対応 0S 

Human68k  | 

収録の 容 

ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

数値 調整 ボタン （アップダウン ボタン)、 スライド ボリューム、 テキスト エディット 
の 連係 化理 （ボタン や スライド ボリ ューム を 移動した ときに 数値を 増減させる など） 

を 楽に 行う ための ライブラリ。 

N0.118 

adpplay.r  ||  々類  |  ¥MUSIC¥ADPPLAY 

作者 お 

けんと 

ネホ応 0S 

SX  2.0 の J;- 

収録 内容  バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

複数 起動 可能で、 再生 周波数の 指定が 可能な ADPCM ファ イ ルを 蜗らす プロ グラム。 

備考 

複数 起動には、 PCM8.X  (江 藤氏 作） およ び 互 横 ドライ バが 必要。 
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No.119 

SXCDP.X  \ 

分類 

¥MUSK：¥SXCDP 

作者 名 

結 城 あすか  \ 

が応 OS 

SX  3.0 社  \ 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

NIFTY-Serve  \ 

紹介 

SX- WINDOW 上で 動作 争る、 CD-ROM ドライブを 用いた 音楽 CD 再生 プロ グラ 

ム。 一般の 音楽 CD 再生 機と 同等の 機能 を 備えて いる。 

備考 

CDDEV.SYS 情卜測 技研 製 CD-ROM デ バイ ス ドライバ） が 必要。 

No.120 

SXWAVPLAY.X  分類 

¥MUSIC¥SXWAV 

作者 名 

Yokko 

が応 OS 

SX  2.0 じ [上  収録 内容 

別途 ソ ー スフ アイ ル同捆 

サポート ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で .WAV ファイル、 または .AVI ファイル 中の 音声 デー タを 巧 
生す る プログラム。 

備考 

PCM8.X  (江 藤氏 作） およ び 互換 ドライ バが 必要。 

N0.121 

SXZC.r 

分類 

¥MUSIC¥SXZC 

作者 名 

けんと 

が応 OS 

SX  3.0 り 1  上  /  Z-MUSIC 
ver. 2.00 じ 1上 

収録 内容 

第 3 版 83 刷の ソースファイル 
同 糊 

サポ ー ト ネット 

Network-SX  NG/NIFTY- Serve 

紹介 

ZMUSIC.X,  rcd.x  等の 曲 デー タ （拡張 子 . opm,  .zmd,  .zms, .皿 dx,  .mdn, .皿 df, 
.rep,  .r36,  .mcp, .皿 dz, .皿 di,  .zdf ,  .mid,  .mff,  . std) を 再生す るプ ログ ラ 

ム〇 

備考 

第 3 版 85 刷の 差分 ファイル 同硝。 一部 データ 再生には 別途 nizp.x 力、 •必要。 SX-BASIC 
対応。 

N0.122 

印刷 中は 演奏 停止 .r 
/mzi .x/opm  し .X 
/c 皿 64reveb. sxb 

分類 

¥MUSIC¥SXZCSUP 

作者 名 

けんと 

が応 OS 

SX  3.1 

収録 内容  ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SXZC.r  (けんと 氏 作） の サポー ト プログラム。 

No.123 

WordMaker.X 

分類 

¥MUSIC¥WO 民  DMK 

作者 名 

結 城 あすか 

が応 OS 

SX  3.0 社 

収録 内容 

バイナリ のみ 

サポート ネット 

NIFTY-Serve 

紹介 

SXCDP.X 懈城 あすか 氏 作） で 利用で き る 歌詞 表示 用の データ 作成 支援 プログラム。 

備考 

cddev.sys  (計測 技研 製 CD-ROM デ バイ ス ドライバ） が 必要。 

N0.124 

SXP1.X 

分類 

¥TE  民  M¥BPLUS 

作者 名 

けんと 

対応 OS 

SX  3.1  1 

1 収録 内容  1 

1 別途 ソースファイル 同が 

サ ポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

Communication  SX-68K と QuTERM で 使用可能な、 B-Plus プロ トコ ル 転送 プ 
ロ グラム。 
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N0.125 

コン ピュー タ 画面 .r 

分類 

¥TERM¥CZCOMP 

作者 名 

けんと 

が応 0S 

SX  3.1 

収録の 容 

ソースファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

QuTERM.X でリ ダイ アル中に テレビを 見る ことができ る' 7°  ログ ラム。 

備考 

專用 ディ ス プレイ TV が 必要 （CZ-6XX シリ — ズ)。 

N0.126 

gnus .el/ (ま 力、 

分類 

¥TERM¥GNUS 

作者 名 

BAA 

対応 0S 

SX  义 1  /  Human68k  3.02 

収録 内容 

lisp マクロ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

Mule や Nemacs 上で イ ンタ ー ネット 緒 山の ニュ ー ス を 読む ための ニュ ー スリ ー 
ダ。 

No.127 

SXP2 . X 

分類  ¥TERM  ¥MLINK 

作者 名 

PRAY 

列 •応 0S 

SX  3.0 り J こ 

収錬 内容  バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

Communication  SX-68K と QuTERM で 使用可能な MLINK プ ロト コル 転送 プロ 
グラム。 

N0.128 

nr  .X 

分類  ¥TE 民 M¥N 民 

作者 名 

Mew 

対応 0S 

SX 义 1 

収録 内容  別途 ソー スフ アイ ル 同 拙 

サポ ー ト ネット 

Network-SX  NG 

紹介 

ログファイルを おながら、 アーティクルの ポスト、 フォ ロー、 メールの 送受信を 一 
す 舌で 巧え るよう にす るた めの、 オフライン. ニ ューズ りーダー プログラム， 

N0.129 

QINT.X 

分類 

¥TERM¥QINT 

作者 名 

PRAY 

対応 0S 

Human68k 

収録 内容 

ソースファイル 同 棚 

サポート ネット 

Network-SX  NG 

紹介 

SX-WINDOW 利用 時に マウス 関係の 削り 込み 負荷を 魅く する ことで、 X680x0 の 
化 理性 能を ほんの わずか だけ 向上 させ、 X68000  XVI じ 1 下 (MPU 68000 の 機種） で 
の 高速 通信 （日 uTERM 支援） に 対応 （DTE 3840 0) させる プログラム。 

備考‘ 

X68030 じ 1  上 （MPU 6803 0,  68040) にも 対 化;。 

No.130 

QuTERM.X 

々類  ¥TERM¥QUTERM 

作者 名 

George 

列 •応 OS 

SX  3.0 じ 1上 

収録 内容  1 別途 ソー スフ アイ ル同姻 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX-WINDOW 上で 動作す る、 LISP インター プ リタを 内蔵し た 究極の 夕ー ミナ ル 
ソフト の フルセット バー ジョン。 NIFTY-Serve や Network-SX  NG の才ー トロ 
グイ ンが 可能。 

備考 

RSDRV  ver. 2.00  U 上 もしくは TMSID .  X の •お 駐が必 嬰。 
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No.131 

QuTERM S.X 

分類 

¥TE  民  M¥QUTE  民  MS 

作者 名 

George 

が応 OS 

SX  3.0 肚 

収鍊 内容 

別途 ソースファイル 同が 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

QuTERM.X の スモール セツ ト バージ ヨン。 メインメモリ 2M バイト でも 起動が 可 
能。 

備考 

RSDRV  ver. 2.00 じ [上 もしくは TMSI0  .X の 常駐が 必要。 

N0.132 

sxqv . X 

分類 

¥TERM¥SXQV 

作者 名 

BLACK. 

対応 OS 

SX  3.0/ 义 1 

収録 内容 

別途 ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG 

紹介 

PC-VAN 等で サポ ート されて いる quidk-VAN のプ ロト コル 転を を 巧う プロ グラ 
ム。 Communication  SX-68K、 QuTERM  等で 利用 可能。 

備考 

RSDRV  •  SYS  ver.2.0 じ [上で 動作 (TMSI0 では 不可)。 ターミナル ソフト か ら 呼ぱれ 
る ことが 前提条件。 

N0.133 

autocase. X 

分類 

¥TOOL¥AUTOCASE 

作者 名 

GRANADA 

対応 OS 

SX  1.1  u  上 

収録 内容 

別途 ソースファイル 同 欄 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

フロ ッ ピー ディ スク 内の すべての ファイル 名、 ディ レクト リ 名を 自動的に 大义 字に 
リ ネーム する プログラム。 

N0.134 

電卓 管理 .r 

分類 

¥TOOL¥CALCMAN 

作者 名 

けんと 

対応 OS 

SX  2.0 り Ji 

収錄 内容 

ソース ファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX-WINDOW 上で [0PT.1]  +  [0PT.2] キーを 抑す ことにより 電卓を 起動す るた 
めの プロ グラム。 実行 オプ シヨ ンの 指定に よって 極々 の 電卓 （数値 演算 .x  :  HI-Br. 
氏 作 等） も 起動 可能。 

N0.135 

calcSx.x 

か 類 

¥TOOL¥CALCSX 

作者 名 

仁 泉大輔 

対応 0S 

SX  3.0 化と 

収録 内容 

ソース ファイル 同釉 

サ ポー ト ネット 

NIFTY-Serve 

紹介 

王 巧 闡数や 変数が 使える 化 用の 計算機 プログラム。 

N0.136 

canvas .r 

II 分類 

¥TOOL¥CANVAS 

作者 名 

けんと 

対応 OS 

SX  3.1 

II 収録 内容  1 

1 ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ビデオ マネージャ (IVM.X,  IVM.LB) でサ ポート される 画像 デー タを 16 色モー ド、 

65 が 6 色 モード ごとに 自 動 判別して 起動す る プログラム。 
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No.137 

CHIDIR! .X 

分類 

¥TOOL¥CHIDI  民 

作者 名 

美姫 

が応 OS 

SX  3.0  U 上 

収録 内容 

バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX-WINDOW から DOS の々 レント ディレクトリ を 変更す る ことができる プ ログ 
ラム。 SX-WINDOW 起動時の々 レント ディレクトリに、 シヤー ペン .X がフ アイ 
ルを 作成す るのを 強制的に 変更す る こと がで きる。 

N0.138 

クリック ノート •  X 

分類 

¥TOOL¥CLNOTE 

作者 名 

高 橋博樹 (HI-Br.) 

が応 OS 

SX  2.0 じ [上 

収録 内容 

別途 ソースファイル 同栖 

サポート ネット 

NIFTY-Serve 

紹介 

クリック ノート .X 上の ボタンを 押す ことじ よって さまざまな アプリケーション 
(SX-WINDOW 内部 コマン ドを 含む） を 割り振る ことが 可能な ランチャ。 1 ぺージ 
ごとに 8 アプリ ケー ショ ンが 登録 可能で、 を 部で 8 ページが 使用可能。 

備考 

SX-BASIC  対応。 

N0.139 

CL0SEWITH0UT.X 

分類 

¥TOOL¥CLOSEWITH 

作者 名 

An 

が応 OS 

SX  2.0 り 

収録 内容 

ソースファイル 同 欄 

サ ポート ネット 

Network-SX  NG 

紹介 

SX シェルの システム アイコン メニュー にある 「全 クロー ズ」 のか わりに、 指定し 
た タスク U 外を 終了す る プログラム。 

No.140 

C0PYBACK.X 

分類 

¥TOOL¥COPYBACK 

作を 名 

VSYNC 

列 •応 OS 

SX3.1 

収録 内容 

バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で 更新され た ファイルを 巧 動的に チェックし、 SX-WINDOW ^ 
了 時に お定 ドライ ブの 指を パスへ ま とめて 転送す る プロ グラム。 

備考 

環境 ファイルに 0PYBACK.ENV) を 使って、 バックアップ をと りたく ない ファイル 
や パスを ワイル ド カー ドで おを する ことが 可能。 

N0.141 

CRTCTRL.r 

分類 

¥TOO し ¥CRTCT 民し 

作者 名 

Sho-Ta 

対応 0S 

SX  3.1 

収録の 容 

バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW の 実國而 サイズを 拡大す るた めの、 フルマ ウス オペ レー シヨ ンの 
CRTC セッ トアッ プ プロ グラム。 

備考 

SAdjust.r  ver.1.20  (Sho-Ta  氏倘  瞬の 常駐が 必要。 SX-BASIC  が応。 

N0.142 

カップ めん .X  1 

分類  1  ¥TOOL¥CUPMEN 

作 お 名 

カ ップ めん 

対応 OS 

SX  3.0  U 上 

収録 内容  1 別途 ソースファイル 同 お 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

カップ めんを 作る ときの タイマー プログラム。 30 秒〜 10 かまで、 30 か 単位で 設 
まする ことができる。 
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No.143 

doc .  X 

分類  ¥TOOL¥DOC 

作者 名 

RK：E 

対応 0S 

SX  3.1  /  Human68k 

収録 内を  バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

指定の ビュー ア （less.  X、 シャー ペン .X 等 複数 指定 可能） で、 お 張子 .DOC,  .MAN 
等の マニュアルを 読み込む ための プログラム。 

備考‘ 

シャー ペン . X 上の コン ソー ルから の 呼び出 しじ も 対応。 

N0.144 

DirViewer .X 

分類 

¥TOOL¥DV 

作者 名 

Guges 

が応 0S 

SX 义 01 じ 1 上 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 特定の ディレクトリ を 短時間 かつ 簡単に 表示. オープン する 
ことができる デイ レクト リビュ ーア。 

N0.145 

EMAGENCY.r 

分類 

¥TOOL¥EMAGEN 

作者 名 

Yoz. 

対応 0S 

SX 1.1 化と 

収録 内容 

バイナリ のみ 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

システム イベント ENDTSK を 疑似 的に 作成して、 SX シェルを 含む すべての タス 
クを 終了させる プログラム。 

N0.146 

数値 演算 .X 

分類 

¥TOOL¥ENZAN 

作者 名 

高 橋博樹 （HI-Br.) 

対応 0S 

SX  2.0 社 

収録 内容 

別途 ソースファイル 同栖 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

閱数グ ラ フ 機能 付き 閱数 電卓 プログラム。 

備考 

SX-BASIC  対応。 

N0.147 

F2SC.X 

分類 

¥TOOL¥F2SC 

作者 名 

カ ップ めん 

が応 0S 

SX  3.0  U 上 

収録 内容 

別途 ソースファイル 同捆 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ファイルの 内容を デスク トッ プス クラ ッ プに 直接 コピーす る こと がで きる プロ グラ 
ム。 

N0.148 

GARBAGE. X 

分類 

¥TOOL¥GARBAGE 

作者 名 

KUM 

対応 0S 

SX  3.0 の Ji 

収録 内容 

ソース ファイル 同烟 

サポート ネット 

Network-SX  NG 

紹介 

終了 した タスクが メモリ ブロ ッ クを 未開 放の まま 残して いない かどう かを 調べて 
報告し、 必要 に応じて それらを 削 放す るた めの プログラム。 
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No.149 

画面 コ ピ ー .X 

分類 

¥TOOL¥GCOPY 

作者 名 

Yokko 

が応 OS 

SX 义〇 じ [上 

収録 内を 

バイナリ のみ 

サポート ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 画面 イメ ージ をクリ ッ プボー ドに 転送す る プログラム。 テキ 
スト 画面、 グラフィック 画面 巧 方に が応。 

No.150 

ミ 凡 用 トレイ.： X 

分類 

¥TOOL¥HANTRAY 

作者 名 

PRAY 

対応 OS 

SX  3.1 

収録 内を 

ノ 、•イナり のみ 

サポート ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上から 実行で きる 多 機能な ファイル ト レイ プログラム。 

備考 

いろいろ な 用途の 環境 ファ イ ルイ 寸属 （*  •  cnf  )。 

N0.151 

HisClip.X 

分類 

¥TOOL¥HISCLIP 

作者 名 

离 橋傅樹 （HI-Br.) 

が応 0S 

SX  2.0 じ [上 

収録 内を 

別途 ソースファイル 同捆 

サ ポート ネット 

NIFTY-Serve 

紹介 

SX-WINDOW のクリ ッ プボー ドに 送られて くる デー タのう ち、 最新の 16 件を 保 
存 して おく プログラム。 

N0.152 

越後 屋残量 .X 

分類 

¥TOOL¥HZAN 

作者 名 

越後 屋 

対応 OS 

SX  3.0 じ [上 

収錄 内容 

バイナリ のみ 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

SX-WINDOW 上で 動作し、 メモリ や ハー ド ディスク などの 補助 記 惊装證 の 空き 
を巍を リアルタイムで 表示す る プログラム。 

N0.153 

IVMInfo.x 

分類 

¥TOOL¥IVMINFO 

作者 名 

BLACK. 

が応 OS 

SX  3.1 

収鍊 内を 

ソースファイル 同 欄 

サ ポー ト ネット 

Network-SX  NG 

紹介 

ビデオ マネージャ (IVM.X,  IVM.LB) に證 緑され ている 画像 形式の リソース 情報を 
表示す る プログラム。 

N0.154 

こんな もの ポイ だ •て 

分類 

¥TOOL¥KONPOI 

作者 名 

けんと 

が応 OS 

SX  义 1  1 

1 収録 内容 

ソースファイル 同 欄 

サポート ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

アイコン リスト、 アイコン メンテな どで 設を する ことにより、 ファイル （複数 も 可） 

を ダ ブルクり ック する だけで ク リーナ に 捨てる ことができる プログラム。 

N0.155 

MF0CK.X  1 

1 分類  1 

1  ¥TOOL¥MFOCK 

作者 名 

VSYNC 

対応 OS 

SX  3.1 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で、 一度に 複数の ファ イ ルを 実 斤す るた めの プロ グラム。 
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No.156 

Mini.x 

分類 

¥TOOL¥MINI 

作者 名 

Guges 

が応 OS 

SX  2.0  上 

収録 内容 

バイナリ のみ 

サ ポー ト ネット 

NIFTY-Serve 

紹介 

デスクトップ 上の ウインドウの 配置を 縮小して 表示し、 それぞれに クロー ズ 、アク 
テイべー ト 等の コント ロー ルを 行う ことができ るフ 。ログ ラム。 

N0.157 

文字列 検索 .X 

分類 

¥TOOL¥MOJI 

作者 名 

ウィル 

が応 0S 

SX  3.0 じ [上 

収録 内容 

別途 ソース 同 お 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

正規表現 検索 等を サポート した 高機能な 文字列 検索 プログラム。 

N0.158 

NDS.X 

分類  ¥TOOL¥NDS 

作者 名 

PRAY 

が応 0S 

SX  3.1 

収録 内容  バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG 

紹介 

シャ— ペン X の 文書 保存の デフォルトの ファイル 名 （TEXT?.  PEN) を、 任意の ファ 
イル 名に 変更す る プログラム。 

N0.159 

新 パス 名 .X 

分類 

¥T00L¥NEWPATH 

作者 名 

特 ひ 級 電脳 師 

が応 0S 

SX  3.0 

収録 内容 

ソース ファイル 同 欄 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

ファイル 名、 パス 名、 フルパス 名を 表示した リ、 表示した ファイル 名 等を クリップ 
ボー ドに 転送した りする プログラム。 

No.160 

ぬるぬる .X 

分類 

¥T00L¥NURU 

作者 名 

カ ップ めん 

が応 0S 

SX  3.0  U 上 

収録 内容 

別途 ソースファイル 同捆 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ファイル 中の ヌル 記号 （NULL) を 取り除き、 CR/LF を CRLF に 変換し、 タブ コード 
を スぺー スコー ドに 変換す る プログラム。 

N0.161 

OpenDir ! . X 

分類 

¥TOOL¥OPENDIR 

作者 名 

かご や 

が応 0S 

SX  3.0 じ [上 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

深く 階 暗 化した ディ レクトり を、 SX-WINDOW 上で 短. 時間 かつ 節 単に 表示 .オー 
プン する プログラム。 

N0.162 

path .  X  1  々類 

¥TOOL¥PATH 

作者 名 

Eban.W 

対応 OS 

SX  3.1 

収録 内容  バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で ドラッグ された ファイル アイ コンの パス 名を 表示し、 クリッ 
プ ボー ドに 転送す る プログラム。 
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No.163 

PICIC0N.X 

分類 

¥TOOL¥PICCON 

作者 名 

VSYNC 

対応 OS 

SX  3.0 な 上 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

SX-WINDOW 上で IVM .  X が 扱える 晒 像 デー タ を 縮小. 減 色 化理す る ことによ っ 
て PAT4 おすの 画像 デー タじ 変換し、 同時に ICON  .LB へ アイ コンを 自動 登録 （も 
しくは 削除） する ための ツール。 

備考 

IVM.X が 常駐して いる こと。 

N0.164 

ps.x,  kill.x 

分類 

¥TOO し ¥PSKI しし 

作者 名 

かご や 

対応 OS 

SX  3.1 

収録の 容 

バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

シャー ペン .X のコ ンソー ル 上で 動く プログラム。 ps.x は プロセスを 表示し、 
kill.x は タスクの 終了を 斤う もの。 

N0.165 

pt4get . X 

分類 

¥TOOL¥PT4GET 

作者 名 

BAA 

が応 OS 

SX  3.1 

収録 内容 

ソースファイル 同 拙 

サポ ー ト ネット 

Network-SX  NG 

紹介 

シャー ペン 形式の ファイル （アイコンが 埋め込まれた ドキ ュメン ト 等） から PAT4 
おすの デー タを ドラッグ したり、 メニ ューを 使って PAT4 形式の データの 才ープ 
ン、 スクラップへの コピ ー、 ICON. LB への 登録が 可能な プログラム。 

N0.166 

PICTtoDRAW.x 

か 類 

¥TOOL¥PICTDRAW 

作者 名 

高 橋博樹 （HI-Br.) 

対応 0S 

SX  2.0 じ [上 

収録のを 

ソースファイル 同 棚 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

クリ ッ プボー ドに ある PICT データを Easydraw.X で 利用 可能な DRAW デー タに 
変換す る プログラム。 

備考 

シヤー ペン .X  {こ 張り かける こと はで きない。 

N0.167 

regsea. ex 

分類 

¥T00L¥REGSEA 

作者 名 

けんと 

が応 0S 

SX'3.1 

収録 内容 

別途 ソースファイル 同 拙 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

正規表現 [regexp] に マッチす る 部分を 検索す る、 シヤー ペン .X の 外部 コマン 
ド。 

備-ぞ 

SX-WINDOW  ver.3.1 付 儀の シヤー ペン . X が 必要。 

N0.168 

名前 変更 .X 

分類 

¥TOOL¥REN 

作者 名 

々ッ プ めん 

が応 OS 

SX  3.0 の 1 

1 収録 内容  1 

別途 ソースファイル 同栖 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ファイル 名 や ボリ ューム 名の 变更 •複製、 新規 ディ レクト りの 作成 や 大文字 小文字 
化、 ノード •が 張子 別の キャ ピタラ イズが 変更 可能な プログラム。 
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No.169 

IVM モジ ユール 削除 .x 

分類 

¥T 00 L¥  民  MIVM 

作者 名 

けんと 

対応 OS 

SX  3.1 

収録 内容 

ソースファイル 同 楠 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

ビデオ マネージャ (IVM.X,  IVM.LB) じ 登録され ている 画像 モジ ュー ルを 登録 解 
除す る プログラム。 

No.170 

roottoscrap.x 

分類 

¥T00L¥R 00 TC0PY 

作者 名 

An 

対応 0S 

SX  3.1 

収録 内容 

ソースファイル 同 拙 

サポ ー ト ネット 

Network-SX  NG 

紹介 

grroot.x  (An 氏倘 等で 表示 された グラフィック 画面を スクラップに コピー する 
ための プログラム。 

備考 

SxPANIC.r  (Sho-Ta  氏 作)、 SAdjust.r  (Sho-Ta  氏 作） が 必要。 

N0.171 

SCopy .  X  ||  分類 

¥T00L¥SC0PY 

作者 名 

カ ップ めん 

対応 0S 

SX  3.1 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

実 画面 全体を デスク ト ップ スクラップに PAT4 形式で コ ピーす る プログラム。 

N0.172 

SendMes . x 

分類 

¥T00L¥SEND 

作者 名 

カップ めん 

が応 0S 

SX  3.0  U 上 

収録 内容 

ソー スフ アイ ル 同 欄 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX-BASIC 形す で、 いろいろな タスクに メ ツ セー ジを をる プログラム。 

N0.173 

SMAutoexec.x 

分類 

¥T00L¥SMAUT0 

作者 名 

ともみ 

が応 0S 

SX  3.0 の Ji 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

スト りー ム マネージャ （streamMan.x  : とも み 氏 作） を 使用 して タ スクの 自動 起 
動と ポート 間の 自動 接続を 斤う プログラム。 

備考 

streamMan.x  ver.0.3 じ [上 （とも み 氏 作） が 必要。 

N0.174 

sxBack.x 

分類 

¥T00L¥SMBACK 

作者 名 

ともみ 

対応 0S 

SX  3.0 じ [上 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

スクラップと ス トリ ーム マネー ジャ （StreamMan.x  : と もみ 氏 作） じよって 提供 
される、 ストリーム によって 壁紙 設 をを 行う プログラム。 

備考 

StreamMan.x  ver.0.4 じ [上 （とも み 氏 作） が 必要。 
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No.175 

SX 加 t  .  X 

分類 

¥T00L¥SMCUT 

作者 名 

ともみ 

が応 OS 

SX  3.0 の Ji 

収録 巧を 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

スクラップと スト リーム マネージャ （streamMan.x  : とも み 氏 作） によ って 提供 
される、 ストりー ム からの 画像を 読み込んで、 その 一部を 切り出す プログラム。 

備考 

streamMan.x  ver.0.4  U 上 （と もみ 氏 作） が 必要。 

N0.176 

sxGailery .X  | 

分類 

¥TOOL¥SMGAL 

作者 名 

ともみ 

列 ■応 0S 

SX  3.0 じ [上 

収録 内容 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

スト リーム マネージャ （StreamMan.x  : と もみ 氏 作） 対応の ビデオ マネー ジャ 
(IVM.X,  IVM.LB) が応 画像 デー タを 表示す る プログラム。 

備考 

StreamMan.x  ver.0.4 じ [上 （と もみ 氏 作） が 必要。 また、 IVM.X が 常駐して いる 
こと。 

N0.177 

sxGFrame.x 

々類  ¥TOOL¥SMGF 

作者 名 

ともみ 

列 •応 0S 

SX  3.0 じ 1上 

収録 内容  バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

65 が 6 色 モー ドでの スク ラップと スト リーム マネー ジャ (streamMan.x  : ともみ 
氏 作） じよって 提供され る、 スト リーム からの 画像 ビュー ア。 

備考 

StreamMan.x  ver.0.3 じ 1 上 （と もみ 氏 作） が 必要。 

N0.178 

SCSt .X 

分類 

¥TOOL¥SMSCST 

作者 名 

ともみ 

が応 0S 

SX  3.0  U 上 

収錄 内容 

バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

スクラップと スト リーム マネー ジャ （StreamMan.x  : とも み 氏 作） によ って 提供 
される、 ストリーム 間の データ交換を 斤う プログラム。 

備考 

StreamMan.x  ver.0.4  U 上 （と もみ 氏 作） が 必要。 

N0.179 

StreamMan.x 

分類 

¥T00L¥SMST 民 EAM 

作者 名 

ともみ 

が応 0S 

SX  3.0 り Ji 

収録 内容 

バイナリ のみ 

サ ポート ネット 

Network-SX  NG 

紹介 

統一的な タスク 間 通信 と タスク 間接 続 確立の ための ュ ーザイ ンター フュー スを提 
供す る プロ グラム。 

備考 

スト リーム マネー ジャ 用の ライブ ラ リが •属。 
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No.180 

sxg2t .X 

分類 

¥TOOL¥SMSXG2T 

作者 名 

ともみ 

対応 OS 

SX  3.0 じ 1 上 

収録 内を 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

ストりー ム マネー ジャ （streamMan.x  : ともみ 氏 作） を 利用して、 入力され た 
65,536 色/ 16 色ビッ ト マップ デー タを プロ ッ ト イメージに 变換 する フィルタ プ ログ 
ラム。 

備考 

streamMan.x  ver.0.4  iU 上、 sxGallery  •  x,  scst  •  x  ( いずれも ともみ 氏 作） など 
の スト リーム 入出カ プログラムと 4M バイ ト じ 1 上の メイ ン メモリが 必要。 

N0.181 

SXAutoDir .X  | 

1 分類  1 

1  ¥TOOL¥SXAD 

作者 名 

PRAY 

対応 OS 

SX  3.1 

収録 内容 

バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

ディ スク褲 入 時に、 ディ スク [巧の ディ レクトり を オープンさせる プログラム。 

N0.182 

SXBdif .X 

分類 

¥TOOL¥SXBDIF 

作者 名 

PRAY 

対応 0S 

SX 义 1 

収録 内を 

バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

バイ ナリ 差分 ファ イ ル 作成 プログラム BDIF.X  (ひがしで 氏倘の SX-WIND0W 
版 プログラム （が: 張子は .BFD)。 

備考 

タスク ごとの メモリ 消 齊盧が 大きい ラージ モデル 差分 同 拙。 FSX.X  ver. 3.00 じ [降 
用。 

N0.183 

SXBJ.X 

分類 

¥TOOL¥SXBJ 

作者 名 

カ ップ めん 

が応 OS 

SX  2.0 化と 

収録 内容 

別途 ソース ファイル 同 棚 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

SX-WINDOW 上で、 ESC/P24 が応 プリ ンタや CZ 系列の プリ ンタを 使って マル 
チ タスクで リスト アウト （文字の み） する プログラム。 

N0.184 

SXBup.x  分類 

¥TOOL¥SXBUP 

作者 名 

PRAY 

が応 OS 

SX  3.1 

収録 内を  バイナリ のみ 

サ ポー ト ネット 

Network-SX  NG 

紹介 

バイナリ 差々 ファイル アップ デー ト プログラム BUP.X  (ひがしで 氏 作） の SX- 
WINDOW 版 プログラム 服 張子は .BFD)o 

備考 

タスク ごとの メモリ 消雙 致が 大 きい ラージ モ デル 差分 同 お。 

No.185 

SX-CRLF.X  1 

1 分類  1 

1  ¥TOOL¥SXC  民  LF 

作者 名 

PRAY 

対応 OS 

SX  3.1 

収録 内容 

別途 ソースファイル 同 拙 

サ ポー ト ネット 

Network-SX  NG 

紹介 

クリ ッ プボー ド 中の テキス ト のな 斤を CRLF  (MS-DOS 形式） に 変更す る フィルタ 
プログラム。 
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No.186 

sx-grep.x 

分類 

¥T00L¥SXG 民 EP 

作者 名 

伊能 富 ± 夫 

が応 OS 

SX  3.1 

収録 内容 

ソースファイル 同捆 

サポート ネット 

NIFTY- Serve 

紹介 

SX-WINDOW 上で ファ イ ル 中の 指を 文字列 を 検査す る プログラム。 awk 互換の 
正規表現が 利用 可能。 

N0.187 

SXjis.x 

分類 

¥TOOL¥SXJIS 

作ち 名 

仁 泉大輔 

対応 0S 

SX  2.0 じ 1上 

収録 内容 

別途 ソースファイル 同捆 

サ ポート ネット 

NIFTY-Serve 

紹介 

EUC,  SJIS， JIS ファイルの 漢字 コードを 変換す る プログラム。 

N0.188 

SXman . x 

分類  ¥TOOL¥SXMAN 

作者 名 

An 

が応 0S 

SX  3.0  U 上 

収録 内容  別途 ソースファイル 同 拙 

サポート ネット 

Network-SX  NG 

紹介 

SX- WINDOW 上で、 が: 張子 .PEN,  .DOC,  .MAN 等の マニュアル および ド キュメ 
ン トの 検索 や 表示. 管理な どを 斤う プログラム。 

備考 

マニュアルを 表示す るた めの プログラム （シ ャー ペン .X 等） が 必要。 

N0.189 

SXmic .X 

夕類 

¥TOOL¥SXMIC 

作者 名 

PRAY 

が応 OS 

SX  3.1 

収録 巧を 

バイナリ のみ 

サポート ネット 

Network-SX  NG 

紹介 

バイナリ テキス トコ ン バー タ mic  (milk. 氏 作成の ish コ ンバー タ） の SX- 
WINDOW 版。 クリ ッ プボー ドを 入 化 力 先に 指を する ことが 可能。 

No.190 

sxmode . x 

み 類 

¥TOOL¥SXMODE 

作者 名 

BLACK. 

対応 OS 

SX  3.0/3.1 

収録 内容 

ソースファイル 同 棚 

サポート ネット 

Network-SX  NG 

紹介 

SX-WINDOW  ver.3.0 の Jj の 旧 16 色モー ド 用に 作られた グラフィック I 划 係の ソフ 
卜が 65,536 をモー ドで 暴走す るのを 未然に防ぐ ための プログラム。 現在の 表示 色 
数を 表示す る。 

N0.191 

mo 皿 0 copy .X 

分類 

¥T00L¥SXM0M0 

作者 名 

亜 山 雪 

対応 OS 

SX  3.1  1 

1 収録 内容 

1 ソースファイル 同 拙 

サポート ネット 

NIFTY-Serve 

紹介 

ハードディスクを テンポラリ 領域と して、 ] 
可能な プログラム。 

[ ドライブで MO ディスクの コピーが 
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No.192 

SXMP.X 

分類 

¥TOOL¥SXMP 

作者 名 

カ ップ めん 

対応 OS 

SX  2.0 社 

収録の 容 

別途 ソースファイル 同捆 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

マウス ポイ ンタの グローバル 座標、 巧寇の ウィン ドウを 基準に した 口一々 ル 座標を 
表示す る プログラム。 

N0.193 

SXPerf orm.X 

分類 

¥TOOL¥SXPFM 

作者 名 

Yokko 

が応 OS 

SX  2.0 社 

収録 内容 

別途 ソースファイル 同栖 

サポート ネット 

NIFTY-Serve 

紹介 

SX- WINDOW 上で 一定 時間 （約 3 秒） ごと に パフ ォ ー マンス 値を 測定して 表示し 
たり、 X68030 の [上 （MPU 68030,680 40) の 機種の キャッシュの 設定と 動作 ウュ イト 
を 設定す る プログラム。 

N0.194 

SxSED.X 

分類 

¥TOOL¥SXSED 

作者 名 

仁 泉大輔 

対応 OS 

SX  3.0 じ 1 上 

収録 内容 

別途 ソースファイル 同栖 

サポ ー ト ネット 

NIFTY-Serve 

紹介 

漢字が 応  sed  (Stream  EDitor)  ver.1.5 民 el.8 の  SX-WINDOW  版。 

N0.195 

sxsh.x 

分類  ¥TOOL¥SXSH 

作者 名 

ドロネ 

が応 OS 

SX  3.1 

収録 内容  別途 ソース ファ イ ル同栖 

サポート ネット 

NIFTY-Serve 

紹介 

アイ コンメ ンテや メニュー メ ンテ など、 実行 ファイルの 設定で 複数の コマン ドを 起 
動したり、 コン ソ ー ル 上で 実行す る コマンドを 直接 指定す る こと がで きる 簡易 シェ 
ル プログラム。 

N0.196 

窓を 後へ 窓を 前へ •：!：/ 窓 
を 操る .r 

分類 

¥TOOL¥WINMAN 

作者 お 

けんと 

が応 OS 

SX  3.1 

収録 内容 

ソース ファイル 同搁 

サ ポー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

クリック ノート .X  (HI-Br. 氏 作） から キー ボー ドを 使って アクティブ ウィンドウ 
を 移動す る プログラム。 

N0.197 

窓を 動かす 2.X 

分類 

¥T00L¥WINM0V 

作者 名 

けんと 

が応 OS 

SX  3.1  1 

1 収録 内容  1 

1 ソースファイル 同 欄 

サポ ー ト ネット 

Network-SX  NG/NIFTY-Serve 

紹介 

クリ ック ノート .x(HI-Br •氏 作） から キーボードを 使って アクティブ ウィ ン ドウ 
を 移動す る プログラム その 2。 ウィン ドウ 枠の 色が 変更 可能。 
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N0.198 

WinThief .X 

か 類 

¥TOOL¥WINTHIEF 

作者 お 

T.A.N 

対応 OS 

SX  3.1 

収録 内が 

バイナリ のみ 

サポ ー ト ネット 

Network-SX  NG 

紹介 

アクティブ ウィン ドウの イメ ージを 取り込み、 クリ ッ プボー ドに PAT4 形式で 転 
送す る プログラム。 

患 Network-SX  NG  Tel.  03-5603-7197  (事情 じよって 電話番号が 変わる 可能性が あ ります。） 


^  sx コール リファレンスの 利用 法 

本 リファレンスでは、 SX コー ルは マネー ジャ 単位で、 原則 t して SX コール 番号 順に 並 
んで います。 ますこ、 ア七ン ブラ レベルでの 各 SX コールに 渡す 引数、 返り 値、 機能な どの 
ほかに、 C 言語で 記述す る 場合の 関数に ついても 解説して います。 C 言語の 関数に ついて 
は、 関数 名、 引数と 型、 返り 値の 型と をの 意味に ついて 解説を 斤って います。 

SX コール ja 外では、 C 言語 用の ライブラリ t しての み 用意され ている 関数 や マクロに 
ついて も ふれて います。 


凡例 


参 $A450 
SX コ ー ルを 号。 

SX コ ー ルを 号の かわ りに [ラ 
イブ ラリ] と 表示され ている も 
のは、 ライブラリと しての み 用 
意され ている 関数を 意味す る。 
[マクロ] と ある ものは、 マクロ 
と しての み 用意され ている こと 
を 意味す る。 


>  SXPack 

コール 名。 


•励 

医 互] と 表示され ている SX コ ー ルは SX- 
WINDOW  ver.2.0 から 追加され たこと 
を 意味して いる。 同様に 屋 互]、 直立] と 表 
示されて いる SX コールは それぞれ SX- 

WINDOW  ver.3.0、 ver.3.1 力 >ら 追加され 
たこと を意咪 している。 


•引数 

コー ルす る 際に ス 
タックに 穗 むべき 引 
数。 その サイズ、 引 
数名、 引数の 持つ 意 
味が 書かれて いる。 
♦返り 値 
呼び出 し 後の 返り- u 
値。 レジスタ とその L 
意味が 嘗 かれて いる。 
♦機能 

コール 機能 解説 0 そ 1 
のコー ルが 持つ 働き 
と 使用 上の 注意が 書 
かれて いる。 


$A450 


SXPack 


日. 1 


引 も* 


巧り 値* ► 


巧 能- 


C の 曲な • 


word  pID  ; データ 圧 お 定萬閒 なの ID 

long  srcLen  ; 圧縮 前の デー タの バイトな 

long  destPtr  ; 圧縮 後の デー タを恪 巧す る バッファへの ポ 

インタ 

long  srcPtr  ; 圧 絡 前の デー タへの ポインタ 

DO.L  圧滿 後の デー タの サイズ/リザ ル トコード 

AO.L  destPtr として 0 を 指ました 巧 合、 デー タ をが 妍 した ハンドル 
srcPtr で 指定した srcLen パイ トの デー タ を、 pID で おました デー タ面館 
をを 閒な じよって 圧 おする。 

結果は destPtr で 指ました バッファ じ 格 がされる。 destPtr として 0 を 
指ました 巧を、 デー タ圧 箱を 義閱 おが 巧 扫己證 可能 ブロックを 確が し そのな か 
で 圧 給 後の データを 格納す る。 この ハンドルは A0.L じあされ る。 

巧が 證が苑 生す る。 

i 凸 t  SXFack( short  pID,  long  srcLen,  void  ♦destPtr, 
void  ♦srcPtr,  Handle  *destHdl) ; 

destP れが NULL の 巧 合、 応追 デー タの ハン ドルは ハン ドル destHdl じ 格納 
される。 

おり 化は 圧 お 後の デー タの サイズ またはり ザル トコー ド。 


>C の 関数 


C の プログラムから SX コールを 呼び 化す 場合の 閒 数を 義、 および 返り 
値 じついての 説明。 間数を 義 では、 それぞれの 引数の 恵睐 がわ かるよう じ、 
[引数] の 欄の 名前と 【巧 一の 名前を 使用して いる。 

^ 返り 値と しては、 原則として [返り 値] で 示した DO 丄の 内容と 同じ もの 
が 返る が、 異なる 場な も ある。 また、 DO と A0 の师 方に 値が 返る コールの 
場合、 引数と して 彼した 変数への ポイ ンタに 返り 値が 返る 場合が ある。 
原則として Workroom  +  SX31KIT 環境に 準じて いる。 


207 


メモ リマン 


；>< モ U7 ン 


#include  〈MEMORY .H〉 


$A000 


MMInitHeap 


引 数 ► long  IZRecord 

返り 値 ►  DO  •  L  リザルト コード 

機能 ► 使用禁止 コール。 

$A00E  MMHeapInit  と 同様。 

ハ 0 ラ メータは レコ ー ド 型。 


; レ コー ドの ア ドレス 


iZ 托 ecord: 


long 

start Ptr 

; ヒープ ゾーン 先頭 ア ドレス 

long 

li 皿 itPtr 

; ヒープ ゾーン 終端 ア ドレス 

word 

cMoreMasters 

; マスタ ポイ ンタ数 

long 

pGrowZone 

; グロー ヒープ ゾーン 関数の アドレス 

この コー ルに よ って 初期化 された ヒ — ブゾー ン は、 メモリ 初期 イヒ 省略 フラ グが 
TRUE になる。 


$A001 


MMGet CurrentHeap 


引数- なし 

返り 値 ►  D0.L  リ ザル トコー ド 

A0.L  カレント ヒー プゾ- 

機能- 使用禁止 コール。 

$A01C  MMChGet  と 同様。 


ンの 先頭 ア ドレス 


$A002 


MMSetCurrentHeap 


引 数 ► long  hz 

返り 値 ►  DO.L  リ ザル トコー ド 

機能 >  使用禁止 コール。 

$A01D  MMChSet  と 同様。 


; ゾーン ヘッダの 先頭 アドレス 


メモ U マン 
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$A003  MMNewHandle 


引 数 ► long  logicalSize  ; 作成す る ブロックの 論理 サイズ 

返り 値 ►  D0.L  リザルト コード 

A0.L  作成され た ブロ ッ ク への ハン ドル 

機能 ► 使用禁止 コール。 

$A021  MMChHdlNew  と 同様。 


$A004  MMSetHandleSize 


引 

数 

long 

h 

long 

newSize 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

ハン ドルが そのまま 返 

機 

能- 

使用禁止 コー ル。 

$A03A 

MMHdlSizeSet  と 同様。 

; サイズを 変更す る ブロ 
; 新しい 論理 サイズ 


ク への ハン ドル 


$A005  MMDisposeHandle 


引 

数- 

long 

h  ； 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

ハン ドルが そのまま 返る 

機 

能 

使用禁止 コー ル。 

$A038  MMHdlDispose  と 同様。 

廃棄す る ブロ ッ ク への ハンドル 


$A006  MMGetHandleSize 


引 数 ► long  h  ; サイズを 得る ブロックへの ハンドル 

返り 値 ►  D0.L  論理 サイズ/リザルト コード 

A0.L  ハン ドルが そのまま 返る 

機能 >  ffi 用 禁止 コール。 

$A039  MMHdlSizeGet  と 同様。 


$A007  MMHLock 


引 数 long 
返り 値 ►  DO.L 
AO.L 


h  ; ロックす る ブロックへの ハンドル 

リ ザル トコー ド 
ハン ドルが そのまま 返る 
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機能 ► 使用禁止 コール。 

$A040  MMHdlLock  と 同様。 


$A008  MMHUnlock 


引 

数 

long 

h  ； 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

ハン ドルが そのまま 返る 

機 

能 

使用禁止 コー ル。 

$A041 

MMHdlUnlock  と 同様。 

ロックを 解除す る ブロックへの ハンドル 


$A009  MMNewPtr 


引 数 ► long  logicalSize  ; 作成す る ブロックの 論理 サイズ 

返り 値 ►  D0.L  リザ ル トコー ド 

A0.L  作成され た ブロックへの ポイ ンタ 

機能 >  使用禁止 コール。 

$A01E  MMChPtrNew  と 同様。 


$A00A  MMDisposePtr 


引 数 ► long  P  ; 廃棄す る ブロックへの ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

A0.L  ポイ ンタ がその まま 返る 

機能 >  使用禁止 コール。 

$A02F  MMPtrDispose  と 同様。 


$A00B  MMGetPtrSize 


引 数 ► long  P  ; サイズを 得る ブロックへの ポインタ 

返り 値 •-  DO.L  論理 サイズ/リザルト コード 

AO.L  ポイ ンタ がその まま 返る 

機能 >  使用禁止 コール。 

$A030  MMPtrSizeGet  と 同様。 


$AOOC  MMSetPtrSize 
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引 数 ►  ]>ong  P 


; サイズを 変更す る ブロックへの ポインタ 


メモ U7 ン 


long  newSize  ; 新しい 論理 サイズ 

返り 値 ►  D0.L  リザルト コード 

A0.L  ポイ ンタ がその まま 返る 

機能 >  使用禁止 コール。 

$A031  MMPtrSizeSet  と 同様。 


$A00D 

MMCompactMem 

引 数 ► long 

cbNeeded  ; 必要な 空き スペース 

返り 値 ►  D0.L 

フリー ブロックの ア ドレス 

A0.L 

フリ ー ブロ ックの アドレス 

機 能- 使用禁止 コール。 

$A010  MMMemCompact  と 同樣。 

$A00E 

MMHeapInit 

引 

数 > 

long 

StartPtr 

ヒープ ゾーン 先頭 ア ドレス 

long 

limitPtr 

ヒープ ゾーン 終端 ア ドレス 

long 

cMorehasters 

マスタ ポイ ンタの 数 

long 

pGrowZone 

グロー ヒープ ゾーン 関数の ア ドレス 

long 

vis 

メモリ 初期化 省略 フラグ 

返り 値 ► 

DO.L 

=  0  エラー 

牛。  ゾーン ヘッダの アドレス 

伴 

1Bc 

能- 

startPtr から limitPtr-l までの ヒープ ゾーンを 生成す る。 

cMoreMasters は〇〜 $7FFF。 これ]^: I 外の 場合、 $40 カタ 旨定 される。 これ 
は、 1 つの マスタ ポイ ンタ ブロ ック のなかに マスタ ポイ ンタ をい く つ 収める か 
を 意味 している。 

pGrowZone で 指定した グロー  ヒープ ゾーン 関数は、 この ヒープ ゾーン をお大 
する 際に 呼ばれる ルーチンの アドレス。 pGrowZone じ 0 を 指定す ると、 デフ ォ 
ルトの ルーチンが 使用され る。 

vis は メモリ 初期化 省略 フラグで、 これに FALSE  (=  0) を 指定した 場合、 こ 
の ヒープ ゾーン から メモリ ブロックを 確保/開放 する 際に 初期化を 行う。 

C の 関数 ►  Heap  *MMHeapInjt (void  *startPtr ,  void  *liinitPtr , 
int  cMoreMasters ,  int  (幸 pGrowZone) 

(Heap  *hz,  long  cbNeeded) ,  BOOLEAN  vis) ; 

返り 値は ゾー ンへッ ダの ア ドレス。 
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$AOOF 


MMBlockMstGet 


引 数 I 


long 

long 


hz 

P 


; ヒープ ゾーンの ア ドレス 
; マスタ ポイ ン タをポ める ブロ ッ クへッ ダの 
アドレス 


返り 値 ►  D0.L  マスタ ポインタ/リザ ル トコー ド 

機 能 ►  P で 指定した 再配證 可能 ブロックの マスタ ポインタを 返す。 P は ブロック ヘッダ 
のア ドレスで ある ことに 注意。 

C  の 関数 ►  Master  *  MMBlockMstGet  (Ueecp  *hz,  Block  *p) ; 

返リ 値は マスタ ポイ ン タ/ リ ザル トコー ド。 


$A010 


MMMemCo 皿 pact 


引 数 I 


; ヒープ ゾーンの ア ドレス 
; 必要な 空き スペース 


long  hz 

long  cbNeeded 

返り 値 ►  DO.L  =0  エラー 

丰り  フリー ブロックへの ポインタ 

機 能 ►  hz で ネ旨定 した ヒープ ゾーンに がして、 CbNeeded で 指定した サイズの フ リー 
ブ ロッ  クが 作成で きる まで、 ブロ ッ クの 再配置を 繰り返す。 

C の 関数 ►  Block  ^MMMemCoinpact (Heap  *hz， long  cbNeeded) ; 

返り 値は フリー ブロ’ ソ ク への ポインタ。 


$A011 


MMMemPurge 


引 数 I 


返り 値 I 


long 

long 

DO.L 


; ヒープ ゾー ンのア ドレス 
; 必要な 空き スペース 


hz 

CbNeeded 
=  0  エラー 

丰り  フリー ブロックへの ポインタ 

機 能 ►  hz で’ 指 •定 した ヒープ ゾーンに 対して、 CbNeeded で 指定した サイズの フリー 
ブロック が 作成で きる まで、 パー ジ 可能 ブロック の パー ジを 繰り 返す。 

C  の 関数 ►  Block  *  MMMemPurge  (Ueajp  幸  hz,  long  cbNeeded) ; 

返リ 値は フリ ー ブロ ッ ク への ポイ ンタ。 


$A012 


MMMemMelt 


; ヒーフ ° ゾーンの ア ドレス 
; 必要な 空き スぺ ース 


引 数  >  long  hz 

long  cbNeeded 

返り 値 ►  DO.L  =0  エラー 

丰〇  フリ ー ブロ ッ ク への ポイ ンタ 
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機 能 ►  hz で 指定した ヒープ ゾーンに 対して、 cbNeeded で 指定した サイズの フリー 
ブロ ックが 作成で きる まで、 再配置 可能 ブロ ックの 再配置と パージ 可能 ブロ ッ 
クの パージを 繰り返す。 

C の 関数 ►  Block  * MMMemMel t ( He ao  *hz,  long  cbNeeded) ; 

返り 値は フリー ブロックへの ポ インタ。 


$A013  MMMemReserve 


引 数 ► long  hz  ; ヒープ ゾーンの アドレス 

long  cbNeeded  ; 必要な 空き スペース 

返り 値 ►  D0.L  =0  エラー 

丰。  フリー ブロックへの ポインタ 

機能 ■-  hz で 指定した ヒープ ゾーン じがして、 CbNeeded で 指定した サイズの フリー 
ブロ ックが 作成で きる まで、 再配置 可能 ブロ ックの 再配置と パージ 可能 ブロ ッ 
クの パージを 繰り返す。 

この コールでは、 できるだけ 下位に フリー ブロックを 作成す る。 そのため、 ロッ 
ク して 使用す る ブロックを 確保す る 前に この コー ルを 呼び出して おくと、 再 配 
置が 効率よ く 斤 われる。 

C  の 関数 ►  Block  *  MMMemReserve  (Heap  *hz,  long  cbNeeded) ; 

返り 値は フ リー ブロックへの ポイ ンタ。 


$A014  MMMemSizeFree 


引 数 ►  long  hz  ; ヒープ ゾーンの アドレス 

返り 値 ►  D0.L  最大の フリー ブロックの サイズ 

機 能 ►  hz で 指を した ヒープ ゾーンの なかの 最大の フリ ー ブロ ックの サイ ズを 返す。 
C の 関数 ► long  MMMemSizeFree  (He  ap  *hz) ; 

返り 値は フリ ー ブロック の サイズ。 


$A015  MMMemSizeComp 


引 数 ► Ion 良  hz  ; ヒープ ゾーン の アドレス 

返り 値 ►  D0.L  ブロックの 物理 サイズ 

機能 >  hz で 指定した ヒープ ゾーン で 再配置を 巧っ た 場合に 得 られ るであろう 最大の フ 
リ ー ブロ ックの 物理 サイ ズを 返す。 実際に 再配置が 行われる わけでは ない。 

C の 関数 ► long  MMMemSizeComp  (Heap  *hz) ; 

返り 値は ブロック の 物理 サイズ。 
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$A016  MMMemSizePurg 


引 数 ► long  hz  ; ヒープ ゾーンの アドレス 

返り 値 ►  D0.L  ブロックの 物理 サイズ 

機 能 >  hz で 指定した ヒープ ゾーンで パージを 行った 場合に 得られる であろう 最大の フ 
リ ー ブロ ックの 物理 サイ ズを 返す。 実際に パージが 斤 われる わけでは ない。 

C の 関数 ► long  MMMemSizePurg (Uea-p  *hz) ; 

返り 値は ブロック の 物理 サイズ。 


$A017  MMMemSizeMelt 


引 数 ► long  hz  ; ヒープ ゾーンの アドレス 

返り 値 ►  D0.L  ブロックの 物理 サイズ 

機 能 >  hz で 指定した ヒープ ゾーンで 再配置と パージを 行った 場合に 得られる であろう 
最大の フリ ー ブロ ックの 物理 サイズを 返す。 実際に 再配置 や パージが 行われる 
わけでは ない。 

C の 関数 ► 1 ong  MMMemSizeMel t ( He ap  ♦hz) ; 

返り 値は ブロック の 物理 サイズ。 


$A018  MMMemErrorGet 


引 数 なし 

返り 値 ►  D0.L  リザルト コード 

機能 ►  メモリ マン で 最後に 発生 した リザルト コードを 得る。 
C の 関数 ►  int  MMMemErrorGet  (void); 

返り 値は リ ザル トコ ー ド。 


$A019  MMMemErrorSet 


引 数 ►  long  resultCode  ; リザルト コード 

返り 値 ►  DO.L  前の リザ ル トコー ド 
機能 ►  リザルト コードを セットす る。 

C の 関数 ►  int  MMMemErrorSet ( int  resultCode) ; 
返り 値は 前の リ ザル トコ ー ド。 


$A01A  MMMemStrictGet 


引 数 なし 

返り 値 ►  DO.L  厳密 チて ック フラグの 内容 
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機 能 ►  厳密 チて ック フラグを 得る。 
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$A01B  MMMemStrictSet 


引 数 ► long  strictFlag  ; 厳密 チェック フラグ 

返り 値 ►  D0.L  前の 厳密 チ卫ッ クフ ラグ 

機 能- 厳密 チュッ クフ ラグを 設定す る。 

厳密 チェック フラグを TRUE にす ると、 メモリ マンに 渡す ハンドル や ポインタ 
は 通常よ り も 厳しく チ 卫ック され、 不当な 値の 場合は エラーを 返す ようじなる。 


$A01C  MMChGet 


引 数 なし 

返り 値 ►  D0.L  =0  エラー 

^0  カレント ヒープ ゾーン の 先頭 アドレス 

機 能 ►  々レント ヒープ ゾーン の 先頭 アドレス （ゾーン ヘッダの アドレス） を 返す。 
C  の 関数 ►  Heap  *  MMChGet  (void) ; 

返り 値は ヒープ ゾーンの 先頭 ア ドレス。 


$A01D  MMChSet 


引 数 ► long  hz  ; ヒープ ゾーンの アドレス 

返り 値 ►  D0.L  =0  正常終了 
丰り  エラー 

機 能 ►  カレント ヒープ ゾーンを hz にす る。 

C の 関数 ►  int  MMChSet  ( He ap  *hz) ; 

返り 値は エラーの 有無。 


$A01E  MMChPtrNew 


引 数 ► Ion 良  logicalSize  ; 作成す る ブロックの 論理 サイズ 

返り 値 ►  D0.L  =0  エラー 

丰〇  作成され た ブロックへの ポインタ 

機能 >  logicalSize の 論理 サイズを 持つ 再配置 不能 ブロックを々 レント ヒー プゾー 
ン 中に 作成す る。 

これに よって 作成され る ブロ ッ クの 属性は、 


• 再配置 不能 
• リソース ビット OFF 
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という 状態になる。 

再配置が 発生す る。 

C の 関数 ►  Pointer  MMChPtrNew ( long  logicalSize) ; 
返り 値は ブロックへの ポイ ンタ。 


$A01F  MMChMstMore 


引 数  >  なし 

返り 値 D0.L  =0  正常終了 
丰。  エラー 

機 能 >  マスタ ポインタ ブロックを 追加 作成す る。 
再配置が 発生す る。 

C の 関数 ►  int  MMChMs tMore (void); 

返り 値は エラーの 有無。 


$A020  MMChMstNew 


引 数 なし 

返り 値 ►  D0.L  =0  エラー 

牛り  新しい ハン ドル 

機 能- 新しい 空の ハンドルを 返す。 メモリの 確保な どは 斤わない。 
再配置が 発生す る。 

C  の 関数 ►  Master  *  MMChMstNew  (void) ; 

返り 値は 新しい ハン ドル。 


$A021  MMChHdlNew 


引 数 long  logicalSize  ; 作成す る ブロックの 論理 サイズ 

返り 値 ►  D0.L  =0  エラー 

丰。  作成され た ブロックへの ハンドル 

機能 ► logicalSize の 論理 サイズを 待つ 再配薦 可能 ブロックを カレント ヒープ 中に 
作成す る。 

これに よって 作成され る ブロ ッ クの 属性は、 

• 再配置 可能 
•  ロックされ ていない 
• パー ジ 不可 
• リソース ビット OFF 
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という 状態になる。 

再配置が 発生す る。 

C の 関数 ►  -Handle  MMChHdlNew (long  logicalSize) ; 

返り 値は ブロックへの ハン ドル。 


$A022  MMChCompact 


引 数 ► 1〇 丘呂  cbNeeded  ; 必要な 空き スぺ ース 

返り 値*^  D0.L  =0  エラー 

丰。  フリー ブロックへの ポインタ 

機 能 ►  カレント ヒープ ゾーンに 対して、 CbNeeded で 指定した サイズの フリー ブロ. ソ 
ク が 作成で きる まで、 ブロ ッ クの 再配置を 繰り 返す。 

C  の 関数 ►  Block  *  MAI  Ch  Compact  (long  cbNeeed) ; 

返り 値は フリー ブロックへの ポイ ンタ。 


$A023  MMChPurge 


引 数 ► long  cbNeeded  ; 必要な 空き スペース 

返り 値- D0.L  =0  エラー 

丰り  フリー ブロックへの ポインタ 

機 能 ►  々レント ヒープ ゾーン に対して、 CbNeeded で ホ旨定 した サイズの フリー ブロ ッ 
ク が 作成で きる まで、 パー ジ 可能 ブロック の パー ジを 繰り 返す。 

C の 関数 ►  B]_ock  ^MMChPurge (long  cbNeeded) ; 

返り 値は フリー ブロックへの ポインタ。 


$A024  MMChMelt 


引 数 ► long  cbNeeded  ; 必要な 空き スペース 

返り 値 •-  D0.L  =0  エラー 

丰。  フリー ブロックへの ポインタ 

機 能 ►  々レント ヒープ ゾーン に対して、 CbNeeded で 指定した サイズの フリー ブロ ッ 
ク が 作成で きる まで、 再配證 可能 ブロック の 再 配 蘆 と パー ジ 可能 ブロック の パー 
ジを 繰り返す。 

C  の 関数 ►  Block  *  MMChMelt  (1cm  を  cbNeeded) ; 

返り 値は フリ ー ブロ ッ ク への ポイ ン タ。 
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$A025 


MMChRe serve 


引 数- 
返り 値 ► 

機 能 


C の 関数 I 


long 

D0.L 


; 必要な 空き スペース 


cbNeeaed 

=  0  エラー 

丰り  フリー ブロックへの ポインタ 

カレント ヒープ ゾーン に対して、 cbNeeded で 指定した サイ ズ のフリ ー ブロ ッ 
クが 作成で き るまで、 再配置 可能 ブロ ックの 再配置と パージ 可能 ブロ ックの パー 
ジを 繰り返す。 

Block  *  MM  ChReserve  (long  cbNeeded) ; 

返り 値は フリー ブロックへの ポイ ンタ。 


$A026 


MMChFreeSize 


引 数 なし 
返り 値 ►  D0.L 


カレン 


ヒープ ゾーンの フリ ー ブロ ッ クの サイ ズの 総和 
= -1  エラー 

機能 ►  々レント ヒープの フリ ー ブロ ックの サイ ズの 総和を 返す。 

C の 関数 ► long  MMChFreeSizeivoid) ; 

返 り 値は フ リーブ ロックの サイ ズの 総和。 


$A027 


MMChGrowHeapGet 


引 数 ►  なし 

返り 値 ►  D0.L  グロー ヒープ ゾーン 関数の アドレス 

機 能 ►  カレント ヒープの グロー ヒープ ゾーン 関数の ア ドレスを 返す。 

C  の 関数 ►  int  MMChGrowHeapGet  (void))  (Heap  *hz,  long  cbNeeded) ; 

返り 値は 関数の ア ドレス。 


$A028 


MMChGrowHe apSet 


引 数 ►  long  pGrowZone  グロー ヒ ープゾ ーン閱 数の アドレス 

返り 値 ►  D0.L  前の グロー ヒープ ゾーン 関数の アドレス 
機 能 ►  カレント ヒープの グロー ヒープ ゾーン 関数の ア ドレスを 設定す る。 

C の 関数 ►  int  ( ^MMChGrowHeapSet ( int  (*pGrowZone)  (Heap  *hz, 
long  cbNeeded) ) )  (Heap  *hz,  long  cbNeeded) ; 

返り 値は 前の 関数の ア ドレス。 
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$A029  MMChPurgeGet 


引 数 なし 

返り 値 ►  DO.L  パージ 脚 数の アドレス 

機 能 ►  々レント ヒープ ゾーンの パー ジ 関数の ア ドレスを 返す。 

C の 関数 ►  void  (幸 MMChjPur が G が （void))  (Heap  *hz,  —Handle  h) ; 
返り 値は 闕数 のア ドレス。 


$A02A  MMChPurgeSet 


引 数 ►  long  pPurge  ; パージ 閒 数の アドレス 

返り 値 ►  D0.L  前の パー ジ 関数の アドレス 

機能 ►  カレント ヒープ ゾーンの パー ジ闕 数の ア ドレスを 設定す る。 

C の 関数 ►  void (*MMC7LPurg’eSet (void  (*pPurge)  (Heap  *hz,  —Handle  h))) 
(Heap  本 hz ,  .Handle  h) ; 

返り 値は 前の 関数の ア ドレス。 


$A02B  MMChCompactGet 


引数- なし 

返り 値 ►  D0.L  再配置 脚 数の アドレス 

機 能  >  々レント ヒープ ゾーンの 再配置 関数の ア ドレスを 返す。 
C  の 関数 ►  void  MMChCompactGet  (void) )  (void) ; 

返り 値は 関数の ア ドレス。 


$A02C  MMChC  ompactSet 


引 数 ► long  pReloc  ; 再配置 関数の アドレス 

返り 値 ►  D0.L  前の 再配置 間数の アドレス 

機 能 >  々レント ヒープ ゾーンの 再配置 闡 数のア ドレスを 設定す る。 

C の 関数 ►  void  C*MMChCompactSet (void  (*pReloc)  (void) ) )  (void) ; 
返り 値は 前の 関数の ア ドレス。 


$A02D  MMPtrNew 


引 数 ►  Ion 良  hz  ; ヒープ ゾーンの アドレス 

long  logicalSize  ; 作成す る ブロ ッ クの 論理 サイズ 

返り 値 ►  D0.L  =0  エラー 

牛り  作成され た ブロックへの ポインタ 
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機 能 ►  hz で 指定した ヒープ ゾーンの なかに logicalSize の 論理 サイ ズを 持つ 再 配 
置 不能 ブロックを、 々レント ヒープ ゾーン 中に 作成す る。 

再配置が 発生す る。 

C の 関数 ►  Pointer  MMPtrNew ( He ap  *hz , long  logicalSize) ; 

返り 値は ブロックへの ポイ ンタ。 


$A02E  MMPtrHeap 


引 数 ► long  p  ; 所厲 する ゾーンを 調べる ブロックへの ポイ 

ンタ 

返り 値 ►  D0.L  =0  エラー 

丰。  ブロックが 所属す る ヒープ ゾーンの 先頭 アドレス 

機能 ►  P で 指定し た 再配置 不能 ブロック が 所属 している ヒ ープ ゾーンの 先頭 ア ドレス 
を 返す。 

C  の 関数 ►  Heap  *  MMPtrHeap  (Point  er  p) ; 

返り 値は ヒープ ゾーン の 先頭 ア ドレス。 


$A02F  MMPtrDispose 


引 数 ► long  P  ; 廃棄す る ブロックへの ポインタ 

返り 値 ►  D0.L  =0  正常終了 
丰り  エラー 

機能 P で 指定した 再 配！！ 不能 ブロックを 廃棄す る。 

C  の 関数 ►  void  MMPtrDispose  (Pointer  p) ; 

返り 値は ない。 


$A030  MMPtrSizeGet 


引 数 ► Ion 呂  P  ; サイズを 得る ブロックへの ポインタ 

返り 値 ►  D0.L  論理 サイズ 

= -1  エラー 

機能 >  P で 指定した 再 配 厳 不能 ブロ ックの 論理 サイ ズを 返す。 

C の 関数 ► long  MMPtrSizeGet  (Pointer  p) ; 

返り 値は 論理 サイズ。 


$A031  MMPtrSizeSet 


引 数  long  P 

long  newSize 


; サイズを 変更す る ブロックへの ポイ ンタ 
； 新しい 論理 サイズ 
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返り 値 ►  DO.L  =0  正常終了 

丰り  エラー 

機能 >  P で 指定 した 再配置 不能 ブロ ックの 論理 サイ ズを newSize じ 変更す る。 
再配置が 発生す る。 

C の 関数 ►  int  MMP か筑 ’zeSet (Pointer  p, long  newSize) ; 

返り 値は エラーの 有無。 


$A032 


MMPtrPropGet 


引 数 ► long  p  ; 属性を 得る ブロックへの ポインタ 

返り 値 ►  D0.L  ブロックの 厲性 

= -1  エラー 

機能 >  P で 指定した 再配置 不能 ブロックの 腐 性を 得る。 

C の 関数 ►  int  MMPtrPropGet  (Pointer  p) ; 

返リ 値は ブロックの 厲 性。 


$A033 


MMPtrPropSet 


引 数 ► long  P  ; 厲 性を 設定す る ブロックへの ポインタ 

long  flags  ; 厲性 

返り 値 D0.L  ブロックの 属性 

= -1  エラー 

機能 >  P で 指定した 再配置 不能 ブロックの 厲性 として fl%s を セットす る。 

C の 関数 ►  int  MMPtrPropSetiFointeT  p,  int  flags) ; 

返り 値は ブロックの 腐 性。 


$A034 


MMMstAllocate 


引 数 ► long  hz  ; ヒープ ゾーン の アドレス 

返り 値 ►  D0.L  =0  正常終了 
丰〇  エラー 

機能 ►  hz で 指定 した ヒープ ゾーンに マスタ ポインタ ブロックを 追加 作成す る。 
再配置が 発生す る。 

C の 関数 ►  int  MMMstAllocate {EeSiip  *hz) ; 

返り 値は エラーの 有無。 


$A035 


MMMstBind 


メモ u マン 


引 数 ► long  hz 


; ヒープ ゾーンの ア ドレス 
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返り 値 ►  DO.L  =0  エラー 

丰り  新しい ハンドル 

機 能 ►  hz で 指定した ヒープ ゾーン 中の、 新しい 空の ハンドルを 返す。 メモリの 確保な 
どは 巧わない。 

再配置が 発生す る。 

C の 関数 ►  Master  *MMMstBind (Heap  *hz) ; 

返り 値は 新しい ハン ドル。 


$A0% 

MMHdlNew 

引 数- 

long 

hz 

; ヒー'/ ゾーンの ア ドレス 

long 

logicalSize 

; 作成す る ブロック の 論理 サイズ 

返り 値 ► 

DO.L 

=  0  エラー 

^ 0  作成され た ブロックへの ハンドル 

機能- 

hz で 指定した ヒープ ゾーン 中に、 logicalSize の 論理 サイ ズを 持つ 再 配麗可 

能 ブロ 

ックを 作成す る。 

再配置が 発生す る。 

C の 関数 ► 

-Handle  MMHdlNew ( He ap 

返り 値は ブロ ッ ク への ハン ドル。 

*hz,  long  logicalSize) ; 

$A037 

MMHdlHeap 

引 数- 

Ion 良 

h 

; 所属す る ゾーン を 調べる ブロックへの ハン 

ドル 

返り 値 

DO.L 

=  0  エラー 

丰〇  ブロックが 所属す る ヒープ ゾーン の 先頭 アドレス 

機 能- 

h で 指定し た 再配置 可能 ブロック が 所属 している ヒープ ゾーンの 先頭 ア ドレス 

を 返す, 

0 

C の 関数 ► 

Heap  ♦MMHdiHeapC -Handle  h) ; 

ヒープ ゾーンの 化頭ア ドレス。 

$A038 

MMHdlDispose 

引 数- 

long 

h 

; 廃棄す る ブロ ッ ク への ハン ドル 

返り 値 ■- 

DO.L 

=0  正常終了 

丰り  エラー 

機 能 >  h で 指定した 再配置 可能 ブロックを 廃棄す る。 
C の 関数 ►  void  MMHdlDispose ( .Handl e  h) ; 

返り 値は ない。 
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$A039 

MMHdlSizeGet 

引 数- 

long 

h 

; サイ ズを 得る ブロ ッ ク への ハン ドル 

返り 値 ► 

DO.L 

論理 サイズ 

= -1  エラー 

機能- 

h で 指定した 再配置 可能 ブロ ックの 論理 サイ ズを 返す。 

C の 関数 > 

long  MMHdJSIzeGet (-Handle  h) ; 

返り 値は 論理 サイズ。 

$A03A 

MMHdlSizeSet 

引 数 

long 

h 

; サイ ズを 変更す る ブロ ッ ク への ハンドル 

long 

newSize 

； 新しい 論理 サイズ 

返り 値 •- 

DO.L 

=0  正常終了 

丰。  エラー 

機 能 ► 

h で 指定した 再配置 可能 ブロ ックの 論理 サイ ズを newSize に 変更す る。 

再配置が 発生す る。 

C の 関数 > 

int  MMHdlSizeSet  ( .Handle 

返り 値は エラーの 有無。 

h, long  newSize; ; 

$A03B 

MMHdlEmpty 

引 数- 

long 

h 

; 空に する ハン ドル 

返り 値 ► 

DO.L 

=0  正常終了 

丰り  エラー 

機能- 

h で 指定した ハンドルを 空に する。 すなわち、 h 力 s' 指して いる 再 配 鼠 可能 ブロ ッ 
クを 廃棄し、 空の ハンドル だけを 残す。 

C の 関数 

int  MM 打 dlEmp かし Handle  h) ; 

返り 値は エラーの 有無。 

$A03C 

MMHdlRealloc 

引 数- 

long 

h 

; ハン ドル 

long 

logicalBvte 

; 斬 しく 確保す る ブロックの 論理 サイズ 

返り 値 ► 

DO.L 

=0  正常終了 

牛り  ェラー 


機 能 ►  ハンドル h じ、 logicalByte の サイズを 持つ 斬し い ブロックを 割 リ 当てる。 

h が 空の ハン ドルでなかった 場合、 h 力ぶ 指して いる 再配置 可能 ブロックは 廃棄 
され、 新しく 確保 された ブロック が 割 り 付けられる。 
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碑 配置が 発生す る。 

C の 関数 ►  int  MMHdlRealloc ( .Hajidle  h , long  logicalByte) 
返り 値は エラーの 有無。 


$A03D 

MMHdlMoveHi 

引 数- 

long 

h 

; 移動す る ブロ ッ ク への ハン ドル 

返り 値 

DO.L 

=0  化 常 終了 

丰〇  エラー 

機 能 > 

ハン ドル h が 示す ブロ ック を、 

できるだけ 上位に 移動させる。 

C の 関数 ►  int  MMHdlMoveHi (.Eandle  h) ; 

返り 値は エラーの 有無。 

$A03E 

MMHdlPropGet 

引 数 

long 

h 

; 腐 性を 得る ブロ ッ ク への ハンドル 

返り 値 

DO.L 

ブロ ック の厲性 

= -1  エラー 

機能- 

h で 指定した 再配置 可能 ブロ ッ 

クの厲 性を 得る。 

C の 関数 ► 

int  MM 打 加 内’ op G がし Handle  h) ; 

返り 値は ブロックの 属性。 

$A03F 

MMHdlPropSet 

引 数- 

long 

h 

; 厲 性を 設定す る ブロ ッ ク への ハンドル 

long 

flags 

； 敵性 

返り 値 

DO.L 

前の 属性 

= _1  エラー 

機能- 

h で 指定した 再配置 可能 ブロ ッ 

クの 属性を flags に 設定す る。 

C の 関数 ►  int  MMHdlPropSet ( _Haiidl e  h ,  int  f  lELgs) ; 

返り 備は 前の 属性。 

$A040 

MMHdlLock 

引 数- 

long 

h 

; ロックす る ブロックへの ハンドル 

返り 値 ► 

DO.L 

=0  正常終了 

丰り  エラ- 

機能 >  h で 指を した 再配置 可能 ブロ ックを ロックす る。 
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C の 関数 ►  int  MM 城 JILoc おし Handle  h) ; 

返り 値は エラーの 有無。 


$A041  MMHdlUnlock 


引 数 ► long  h  ;  ロックを 解除す る ブロックへの ハンドル 

返り 値 ►  DO.L  =0  IE 常 終了 

丰。  エラー 

機能- h て •指定した 再配證 可能 ブロックの ロックを 解除す る。 

C の 関数 ►  int  MMHdl Unlock ( _Handl e  h) ; 

返り 値は エラーの 有無。 


$A042  MMHdlPurge 


引 数 ► long  h  ; パージ 可能に 設定す る ブロックへの ハンドル 

返り 値 D0.L  =0  ぶ 常 終了 
丰。  エラー 

機能 ►  h で 指定した-再配置 可能 ブロックを パージ 可能に 設定す る。 

C の 関数 ►  int  MMHdlPurge ( .Handle  h) ; 

返り 値は エラーの 有無。 


$A043  MMHdlNoPurge 


引 数 ► long  h  ; パージ 不能に 設定す る ブロックへの ハンドル 

返り 値 D0.L  =0  正常終了 
牛。  エラー 

機 能 >  h で 指定した 再配置 可能 ブロックを パージ 不能に 設定す る。 

C の 関数 ►  int  MMHdlNoPurge(J{aiidle  h) ; 

返り 値は エラーの 有無。 


$A044  MMHdlResource 


引 数 ► long  h  ; リ ソース ビットを ON にす る ブロックへ 

の ハン ドル 

返り 値 ►  D0.L  =0  正常終了 
丰り  エラー 

機能 >  使用禁止 コール。 

h で 指定した 再配禮 可能 ブロックの リソース ビットを ON にす る。 
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$A045  MMHdlNo 民 esource 


引 

数- 

long  h 

; リ ソース ビットを OFF にす る ブロックへ 

の ハン ドル 

返り 値 ► 

DO.L  = 

0 

正常終了 

丰 

0 

エラー 

機 

能*^ 

使用禁止 コー 

ル 0 

h で 指定した 再配置 可能 ブロックの リソース ビットを OFF にす る。 


$A046  MMHdllns 


引 数 ► long 

h 

; 操作す る ブロ ックの ハンドル 

long 

offset 

； 論理 オフセット 

long 

length 

； お 張す る バイト 数 

返り 値 ►  DO.L 

=  0 

正常終了 

丰〇 

エラー 

機能 ►  h で 指定した ブロックの offset から ブロック 終端までの 内容を、 lengt:h バ 
イ ト 上位 方向に 転送す る。 その 際、 ブロックは length バイ ト 拡張され る。 
再配置が 発生す る。 


C の 関数 ►  int  MM 打 d/ins し Handle  h, long  offset,  long  length) ; 
返り 値は エラーの 有無。 


$A047 

MMHdlDel 

引 数- 

long 

h 

; 操作す る ブロ ックの ハンドル 

long 

offset 

； 論理 オフセット 

long 

length 

; 削除す る バイト 数 

返り 値 ► 

DO.L 

=  0 

正常終了 

丰り 

エラー 

機 能 ►  h で 指定した ブロックの offset から ブロック 終端までの 内容を、 length バ 
イ ト 下位 ホ 向に 転送す る。 その 際、 ブロックは length バイ ト 縮小され る。 
再配置が 発生す る。 

C の 関数 ►  int  MMHdiDeiC -Handle  h, long  offset , long  length) ; 

返り 値は エラーの 有無。 


$A048  MMBlockUsrFlagGet 


引 数 ►  long  p  ; ブロック ヘッダの アドレス 

返り 値 ►  DO.L  ユーザ フラグの 内容 （word) 
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機能- 使用禁止 コール。 

P で 指定した ブロ ックの ユーザ フラグの 内容を 返す。 ブロ ッ クへッ ダの アド レ 
ス である ことじを 意。 


$A049  MMBlockUsrFlagSet 


引 数 ►  long  P  ; ブロック ヘッダの アドレス 

long  usrflag  ; ユーザ フラグ じ設 をす る 値 

返り 値 ►  DO.L  前の ユーザ フラグ 

機能 ► 使用禁止 コール。 

P で 指定 した ブロックの ユーザ フラグの 内容を usrfl% じする。 ブロックへ ッ 
ダの ア ドレスで ある ことにを 意。 


$A04A  MMBlockUsrWordGet 


引 数 ►  long  P  ; ブロック ヘッダの アドレス 

返り 値 ►  D0.L  ユーザ ワードの 内容 （long) 

機能 >  使用禁止 コール。 

P で 指定した ブロ ックの ユーザ ワー ドの 内容を 返す。 ブロ ッ クへッ ダの アド レ 
ス である ことにを 意。 


$A04B  MMBlockUsrWordSet 


引 数 ► long  P  ; ブロック ヘッダの アドレス 

long  usrword  ; ユーザ ワード じ 設定す る 値 

返り 値 ►  D0.L  前の ユーザ ワー ドの 内を 
機能- 使用禁止 コール。 

P で 指定す る ブロ ックの ユーザ ワー ドに 値を 設定す る。 ブロ ッ クへッ ダの アド 
レスで ある こ とじ 注意。 


$A04C  MMMemAmiTPeach 

引 数 ► long  hz 

long  rProc 
丄 ong  urProc 

返り 値 ►  なし 
機能- 使用禁止 コール。 

hz で 指定 した ヒ ープ ゾーン 中 に 存在す る ブロック じついて、 再配置 可能 ブロック 
にがして は rProc で 指定され る 関数を、 再配置 不能 ブロック にがして は urProc 


ヒープ* ゾーンの アド レス 
再配置 可能 ブロック に対する 化理 
再配置 不能 ブロ ック にがす る化理 


メモ U ミ 


227 


メモ u マン 


で 指定され る 関数を 実 斤す る。 
rProc， urProc の 仕様は 次の とおり。 


rProc 

引 数- 

long 

hz 

; ヒー ゾーンの ア ドレス 

long 

h 

; 巧 配置 可能 ブロ ッ ク への ハンドル 

urProc 

引 数- 

long 

hz 

; ヒープ ゾーンの ア ドレス 

long 

P 

; 再配麗 不能 ブロックへの ポインタ 

どちらも 返り 値に 意味を 持たせ る ことは できない。 特に レジスタを 保存す る必 
要はない。 


$A04D  MMMemHiReserve 


引 数 ► long  hz  ; ヒープ ゾーンの アドレス 

long  cbNeeded  ; 必要な 空き スペース 

返り 値 D0.L  =0  エラー 

丰。  フリ ー ブロックへの ポインタ 

機 能 ►  $A013  MMMe 皿 Reserve が できるだけ 下位に フリー ブロックを 作る のにが し、 

この コールは できるだけ 上位に フリ ー ブロック を 作成す る。 

再配置が 発生す る。 

C  の 関数 ►  Block  *  MMMemHiReserve  (Reap  *hz,  long  cbNeeded); 

返り 値は フリー ブロックへの ポインタ。 


$A04E  MMPtrBlock 


引 数 ► long  p  ; ブロック ヘッダを 求める ブロックへの ポイ 

ンタ 

返り 値 D0.L  ブロック ヘッダ/リザ ル トコー ド 

機 能 ►  P です 旨定 した ブロックの ブロック ヘッダの アドレスを 返す。 

C  の 関数 ►  Block  *  MMPtrBlock  ( Po  inter  p) ; 

返り 値は ブロックへの ポイ ンタ。 


$A04F  MMHdlBlock 


引 数 ►  long  h  ; ブロック ヘッダを 求める ブロックへの ハン 

ドル 

返り 値 ►  D0.L  ブロック ヘッダ/リザ ル トコー ド 

機能 ►  h です 旨定 した ブロ ックの ブロ ッ クへッ ダの ア ドレスを 返す。 

C  の 関数 ►  Block  *  MMHdlBlock  (-Handle  h) : 
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返り 値は ブロックへの ポインタ。 
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$A050  MMHdlMstGet 


引 数 long  hz  ; ヒープ ゾーンの アドレス 

long  P  ; ブロックへの ポインタ 

返り 値 ►  D0.L  マスタ ポインタ/リザ ル トコー ド 

機 能 ►  hz で 指定した ヒープ ゾーンの なかの、 P で 指定した ブロックの マスタ ポインタ 
のア ドレスを 返す。 

C  の 関数 ►  Master  *  MMHdlMstGet  (Heap  *hz ,  void  幸 p) ; 

返り 値は マスタ ポイ ンタ。 


$A051  MMChHiReserve 


引 数 ► long  cbNeeded  ; 必要な 空き スペース 

返り 値 ►  D0.L  =0  エラー 

丰〇  フリー ブロックへの ポインタ 

機 能 ►  々レント ヒープ ゾーン じ 対して、 $A04D  MMMemHiReserve と 同様、 できる だ 
け 上位に フリ ー ブロック を 作成す る。 

再配置が 発生す る。 

C  の 関数 ►  Block  *  MMChHiReserve  (long  cbNeeded) ; 

返り 値は フリー ブロックへの ポイ ンタ。 


$A052  MMChUsrFlagGet 


引数- なし 

返り 値 ►  D0.L  々レント ヒープ ゾーン の ューザ フラグの 内容 

機能- 使用禁止 コール。 

々レント ヒープ ゾーンの、 ユーザ フラグの 巧容を 返す。 


$A053  MMChUsrFlagSet 


引 数 ►  long  usrflag  ; 々レント ヒープ ゾーン の ューザ フラグ {こ 設 

をす る備 

返り 値 ►  D0.L  前の ューザ フラグの 内容 （word) 

機能 >  使用禁止 コー ル。 

々レント ヒープ ゾーンの ユーザ フラグの 内容を usrflag に 設定す る。 
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$A054  MMChUsrWordGet 


引数- なし 

返り 値 ►  D0.L  々レント ヒープ ゾーン のユー ザワー ドの 内容 (long) 
機能 >  使用禁止 コール。 

カレント ヒープ ゾーン の ユーザ ワー ドの 内容を 返す。 


$A055  MMChUsrWordSet 


引 数 ► long  usrword  ; 々レント ヒープ ゾーン の ユーザ ワードに 設 

定 する 値 

返り 値 ►  D0.L  前の ユーザ ワードの 内容 

機能- 巧 用 禁止 コール。 

カレント ヒープ ゾーンの ユーザ ワー ドの 内容を usrflag じ 設定す る。 
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#iiiclude 《CONSOLE  ぶ> 


$A068 


EXEnVDISPST 


引 数 ►  long  usrEntry  ; 割り込み ルーチンの アドレス 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機能 ►  V-DISP 割り 达 みに、 usrEntry で 指定され た 割り込み ルーチンを 設定す る。 
C の 関数 ►  int  の Cl 如  VDj 松 PSTXvoid  (*usrEntryKvoid) ) ; 

返り 値は リ ザル トコ ー ド。 


$A069 


EXDeVDISPST 


引 数 ► long  usrEntry  ; 割り込み ルー チンの アドレス 

返り 値 ►  D0.L  リ ザル トコー ド 

機 能 ►  V-DISP に 登録され ている 割り 达み ルーチン のうち、 usrEntry で 指定され た 
割 り 込み ルーチンを 削除す る。 

C の 関数 ►  int  EXDe VDISPS T( vo i d  (*usrEntry)  (void)) ; 

返り 値は リ ザル トコ ー ド。 
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マウス マン 


#include  <CONSOLE.H> 


$A06A  MSInitCsr 


引数 なし 
返り 値 ►  なし 

機 能 ►  マウス カーソルを 初期化す る。 

力ー ソル パターンは 標準の ものに、 々ー ソル レベルは 0 になる。 
C  の 関数 ►  void  MSInitCsr  (Mold) ; 

返り 値は ない。 


$A06B  MSShowCsr 


引数- なし 
返り 値 ►  なし 

機 能 ►  々ー ソル レベルを +1 する。 

C の 関数 ►  void  MSSiiowCsKvoid) ; 
返り 値は ない。 


$A06C  MSHideCsr 


引 数 なし 
返り 値 ►  なし 

機 能 >  々ー ソル レベルを 一1 する。 

C の 関数 ►  void  MSffic/eCsr (VO id) ; 
返り 値は ない。 


$A06D  MSSetCsr 


引 数 ►  long  TXcsrHdl  ; カーソル レコー ドへの ハンドル 

返り 値- なし 

機 能 ►  々ー ソル パターンを 変更す る。 力ー ソル レベルは 変化し ない。 

疑似 ハン ドル も 可。 

C の 関数 ►  void  MSSetCsr (MsCsr  **TXcsrHdl) ; 

返り 値は ない。 
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$A06E  MSObscureCsr 


引 数- なし 
返り 値 ►  なし 

機 能 ►  マウス々ー ソルの 表示を やめる。 々ー ソル レベルは 変化し ない。 

々ー ソル レベルが 0 の 場合、 マウスが 移動す るか、 $A06D  MSSetCsr を 呼ぶ 
ことで マウス々 ー ソルが 巧 表示され る。 

C の 関数 ►  void  MSObscureCsr  (void) ; 

返り 値は ない。 


$A06F  MSShieldCsr 


引 数 ►  long  rectPtr  ; レク タング ル レコー ドへの ポインタ 

long  of sPt  ; オフ セッ トを 示す ポイント 

返り 値 •-  なし 

機能 ►  マウス々ー ソルが rectPtr で 指定した 矩形 領域と 重なる かどう かを 調べ、 そ 
れに 応じた 処理を 巧う。 

• 重なる 場合 

カーソル レベルを 一1 して、 マウス々ー ソルを 消す。 

• 重ならない 場合 

々ー ソル レベルを 一1 する。 

マウスを 移動す る 力、、 $A06D  MSSetCsr を 呼ぶ ことで 実際に マウス々ー ソル 
が 消される。 

rectPtr で 指定した レク タング ルが ローカル 座標系で 示されて いる 場合、 加算 
する ことで グローバル 座標系に 変換で きる ような ofsPt を 指定す る。 グロー バ 
ル 座標系の 場合は （0,0) を 指を する。 

C の 関数 ►  void  MSShieldCsr ( Re c t  *rectPtr ,  LPoint  of  sPt) ; 

返リ 値は ない。 


$A070  MSGetCurMsr 


引 数 ■-  なし 

返り 値 ►  D0.L  マウス レコードへの ポインタ 

機能 ►  マウス レコー ドへの ポインタを 返す。 

C  の 関数 ►  Mouse  *  MSGetCurMsr  (void) ; 

返り 値は マウス レコ ー ドへの ポイ ンタ。 


233 


マウス マン 


$A071  MSMultiGet 


引 数- なし 

返り 値 ►  DO.L  =0  エラー 

丰り  マウス ス ピー ドの 値 

機能 ►  マウス スピー ドの 値を 返す。 

(移動 量 = マウス 変移 X マウス スピー ド /  256) 
C の 関数 ► long  MSMultiGet  (void) ; 

返り 値は マウス スピードの 値。 


$A072  MSMultiSet 


引 数 ► long  皿 sSpeed  ; マウス スピー ド （1 〜 65535) 

返り 値 ►  D0.L  =0  エラー 

牛り  前の マウス スピー ドの 値 

機 能 ►  マウス スピードの 値を 皿 sSpeed にす る。 

(移動 量 ニ マウス 変移 X マウス スピー ド /  256) 

C の 関数 ► long  MSMu む iSet(!Long  msSpeed) ; 

返り 値は 前の マウス スピー ドの 値。 


$A076  MSBoundGet  I  g •日 


引数 >  なし 

返り 値 ►  D0.L  レク タング ルレ コードへの ポインタ 

機 能 ►  マウスの 移動 範囲を 意味す るレク タング ルレ コード （グローバル 座標系） への 
ポイ ンタを 返す。 


$A077  MSBoundSet  I  a.o 


引 数 ►  long  rectPtr  ; レク タング ル レコー ドへの ポインタ 

返り 値 ►  D0.L  レク タング ル レコー ドへの ポインタ 

機能 >  使用禁止 コール。 

マウスの 移動 範圃 rectPtr で 示される 範囲に 設定す る。 


$A078  MSMove 


引 数 long  pt  ; マウス ポインタの グローバル 座標 

返り 値 ►  D0.L  レク タング ルレ コードへの ポインタ 
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機能 ► 使用禁止 コー ル。 

マウス ポイ ンタの 位置を pt に 移動す る。 
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アニ 乂ーシ ヨン 7 ン 


#include  <CONSOLE.H> 


$A073 


EXAnimStart 


引 数 ► long 
long 
long 

返り 値 DO.L 


nmbPtn 

vcount 

ptnList 

リ ザル トコ ー ド 


パターン 数 

書き換え カウンタ 初期値 a 〜） 

々一 ■ソル レコー ドへの ハン ドルの 配 か J 


機 能 ►  々ー ソルの アニメーションを 開始す る。 

C の 関数 ►  int  EXAnimStart ( int  nmbPtn ,  int  vcount  ,MsCsr  ***ptnList) ; 
返り 値は リザ ル トコー ド。 


$A074 


EXAnimEnd 


引 

数 

なし 

返り 値 

D0.L  リザルト コード 

機 

能- 

カーソルの アニメ ー シヨ ンを 終了す る。 

C の 関数 

. int  EXAnimEndivoid) ; 

返り 値は リ ザル トコ ー ド。 

$A075 


巨 XAnimTest 


引 数- 
返り 値 ► 


なし 

D0.L 


0 


アニメーション していない 
=-1  アニメー ション 実 斤 中 

機 能 ►  カーソルの アニメーションが 態を 調べる。 

C  の 関数 ►  BOOLEAN  EXAnim  Test  (void) ; 

返り 値は アニメ ー ショ ン 状態。 
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キ ー ボ ー ド マン 


拌 include  <CONSOLE.H> 


$A086  KBMapGet 


引 数 ►  long  kbRec  ; キー ボード レコー ドの アドレス 

返り 値 ►  D0.L  キーマップの アドレス 

機 能 ►  kbRec で 指ました キーボード レコードの なかの、 キーマップの アドレスを 返す。 
C の 関数 ►  char  *KBMapGet (KBoaxd  ♦kbRec) ; 

返リ 値は キー マップの ア ドレス。 


$A087  KBShiftGet 


引 数 ► long  kbRec  ; キーボード レコー ドの アドレス 

返り 値 D0.L  シフトキー ビット 

機 能 ►  kbRec で 指定した キー ボー ドレ コードの なかの シフ トネー ビットを 返す。 
C  の 関数 ► long  KBShiftGet  (KBoaxd  *  kbRec) ; 

返り 値は シフ トキ ー ビット。 


$A088  KBShiftSet 


引 数 ► long  kbRec  ; キーボード レコードの アドレス 

long  newSBit  ; 新しい シフ ト キービ ッ トの値 

返り 値 ►  D0.L  前の シフ トキー ビット 

機 能 ► げ Rec で 指定 した キー ボー ド レコー ドの なかの シフト キー ビットを newSBit 
の 値に 設定す る。 

C の 関数 ► 1011 良  KBShiftSet (KBoard  *kbRec,  long  newSBit) ; 

返り 値は 前の シフ トキ ー ビット。 


$A089  KBSimulate 


引 数 ►  long  kbRec  ; キーボード レコードの アドレス 

long  kData  ; キー デー タ 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  キー ボードから 趾 ata で 示される 1 义 字を 入力した ふりを する。 

kData の 値は、 キ ーボー ドから 送られて くる デー タと 同様。 つま リ、 キーコ ー 
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ド （/  JIS コード） じ 'f 押された （0x00)/ 離された （0x80)，， 情報を 加え 
たもの。 

C の 関数 ►  int  KBSimulateiKBoard  幸 kbRec,  long  kData) ; 

返り 値は り ザル トコ ー ド。 


$A08A  KBScan 


引 数 ► long  kbRec  ; キ ーボー ドレ コードの アドレス 

返り 値 ►  D0.L  キー バッファ 先頭の データ 

機 能 ►  kbRec で 指定した キー ボー ドレ コー ドの なかの キー バッファの 先頭の データを 
参照す る。 キー バッファが 空の 場合は 0 力ぶ 返る。 

C  の 関数 ►  int  KBScan  (KBoard  *  kbRec) ; 

返り 値は キー バッファ 先頭の データ。 


$A08B  KBGet 

引 数 ►  long  kbRec  ; キー ボード レコー ドの アドレス 

返り 値 ►  D0.L  キー バッファ 先頭の データ 

機 能 ►  kbRec で 指定した キー ボー ドレ コー ドの なかの キー バッファの 先頭の デー タを 
得る。 得られた データは バッファから 除かれる。 キー バッファが 空の 場合は 0 
が 返る。 

C の 関数 ►  int  KBGet  (KBoard  *kbRec) ; 

返り 値は キー バッファ 先頭の データ。 


$A08C  KBEmpty 


引 数 ► Ion 良  kbRec  ; キー ボード レコー ドの アドレス 

返り 値 ►  なし 

機 能 ►  kbRec で 指定した キー ボー ド レコー ドの なかの キー バッファを 空に する。 
C  の 関数 ►  void  KBEmpty  (KBoard  幸  kbRec  ) ; 

返り 値は ない。 


$A08D  KBInit 


引 数 ► long  buflen 

丄 ong  flags 


; ハ* ッファ の バイト 数 
; フラグ 


キ If ト マン 
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bitO 

HALT 

bitl 

RESET 

bit2 

OLD 

bits 

LED 

bit4 

CLICK 

bits 

ASSIGN 

bite 

REPEAT 

返り 値 ►  DO.L  =0  エラー 

丰。  キ ー ボ ー ド レコ ー ドの アドレス 

機 能 ►  キーボード マンを 初期化す る。 

C の 関数 ►  KBoard  ^KBInitiint  buf len,  int  flags) ; 
返り 値は キー ボー ドレ コードの ア ドレス。 


$A08E  KBTini 


引 数 ►  long  kbRec  ; キー ボード レコ _ ドの アドレス 

返り 値 ►  なし 

機 能 ►  キーボード マンの 終了 化理を 巧う。 

C の 関数 ►  void  KBTini  (KBoard  kbRec) ; 

返り 値は ない。 


$A08F  KBCurKbrGet 


引数 なし 

返り 値 ►  D0.L  キー ボード レコー ドの アドレス 
機 能 ►  キーボード レコードの アドレスを 返す。 

C の 関数 ►  KBoard  *KBCurKbrGet(vo±d) ; 

返り 値は キー ボー ドレ コー ドの ア ドレス。 


$A090  KBOldOnGet 


引 数 ► long  kbRec  ; キーボード レコー ドの アドレス 

返り 値 ►  D0.L  =0  OLD  OFF 
丰。  OLD  ON 

機 能 ►  kbRec で 指定した、 キーボード レコー ドに 設定され ている OLD  ON フラグの 設 
定が i 兄を 返す。 

C の 関数 ►  BOOLEAN  fC 及 OWOnG が （战 oar 过  *kbRec) ; 

返り 値は OLD  ON フラ グ のが 態。 
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$A091 


KBOldOnSet 


引 数 I 


long 

long 


KbRec 

newOld 


; キー ボー ドレ コードの アドレス 
; 新しい OLD の 設定 


0 

OLD  OFF 

-1 

OLD  ON 

返り 値 DO.L  前の OLD の 設定 状況 

機 能 ►  kbRec です 胃定 した キー ボー ドレ コードに、 OLD の 設定を 行う。 

C の 関数 ►  BOOLEAN  KBOldOnSetiKBoard  幸 kbRec,  BOOLEAN  newOld) : 
返り 値は 前の DLD  ON フラ グの 状態。 


$A092 


KBFlagGet 


引 数 • 
返り 値 ■ 


long 

DO.L 


kbRec  ; キー ボード レコードの アドレス 

キー ボー ド マンの フラグ 


bitO 

Halt 

bitl 

Re set On 

bit2 

OldOn 

bits 

LedOn 

bit4 

ClickOn 

bits 

Repeat On 

bite 

AssignOn 

機 能 ►  キー ボー ド マンの フラグ 類を 一巧して 返す。 
C の 関数 ►  int  KBFlagGet (KBoeLTd  ♦kbRec) ; 
返り 値は フラグの が 態。 


$A093 


KBFlagSet 


引 数- 


long 

long 


kbRec 
心 gs 


; キーボード レコー ドの アドレス 
； フラグ 類の が 態 


bitO 

Halt 

bitl 

ResetOn 

bit2 

OldOn 

bits 

LedOn 

bit4 

ClickOn 

bits 

RepeatOn 

bite 

AssignOn 

返り 値 DO.L  前の フラグの が 態 

機 能  >  ネー ボード マンの フラグ 類を 一巧して 設定す る。 

C の 関数 ►  int  KBFlagSet (KBoaxd  幸 kbRec， int  flags); 
返り 値は 前の フラ グ のが 態。 
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キ — V ン 


#i 丘 elude  〈CONSOLE. H> 


$A09A 


KMEmpty 


弓 I 数 ►  long  kmReePtr  ; キー マン レコー ドへの ポインタ 

返り 値 ►  なし 

機 能 ►  kmReePtr で 指を した キー マン レコ ー ドの なかの メ ッ セージ キューを 初期化し、 
空に する。 

C  の 関数 ►  void  KMEmpty  (Key  幸 kmReePtr ) ; 

返り 値は ない。 


$A09B 


KMPost 


引数- long 
long 
long 

返り 値 ►  DO . L 
機 能- 


kmReePtr 

kData 

aseCode 

リ ザル トコード 


キ ー マン レコ ー ド への ポインタ 
キー データ （最下位 8 ビッ ト のみ 有効） 
ASCII コード （最下位 8 ビット のみ 有効） 


kData と aseCode から メ ッ セー ジを 作り、 kmReePtr で 指を した ネー マン レ 
コー ドの なかの メ ッ セージ キュー に 登録す る。 

C  の 関数 ►  int  KMPost  (Key  ♦kmReePtr,  int  kData,  int  aseCode) ; 

返り 値は リ ザル トコ ー ド。 


$A09C 


KMAseJobSet 


弓 I 数 ►  long  kmReePtr  ; キーマン レコー ドへの ポインタ 

long  jobAdr  ; 化理 ルーチンの ァ ドレス 

返り 値 ►  D0.L  前の 処理 ルー チンの アドレス 

機 能 ►  Asejob として jobAdr で 指定した ルーチンを 登録す る。 

C  の 関数 ►  int  (*  KMAseJobSet  (Key  ♦kmReePtr,  int  (*  jobAdr)  (void) )) 
(void) ; 

返り 値は 前の 処理 ルーチンの ア ドレス。 


$A09D 


KMSimulate 


弓  I  数 ► long  kmReePtr 


; キーマン レコ ー ドへの ポイ ンタ 


キーマン 


long  kData  ; キー データ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  kData で 指定した キー データに よって メッセージを 生成す る。 シフト キービ ッ 
卜、 マップの 操作 も 斤う。 

C の 関数 ►  int  KMSimulateiKey  ♦kmRecPtr ,  int  趾 ata) ; 

返り 値は リ ザル トコー ド。 


$A09E  KMTask 


引 数 ►  Ion 呂  kmRecPtr  ; キー マン レコー ドへの ポインタ 

返り 値 ►  D0.L  なし 
機能 >  キーマンを 駆動す る。 

イ ベン ト マンが 使用す る。 

C の 関数 ►  void  の V す Tas]c(Key  ♦kmRecPtr) ; 

返り 値は ない。 


$A09F  KMInit 


引 数 ►  long  buf len  ;  メッセー ジキ ューの バイ ト数 

返り 値 ►  D0.L  =0  エラー 

^  0  キ ー マン レコ ー ド への ポインタ 

機 能 >  キーマンを 初期化す る。 キーボード マンが 初期化され ている 必要が ある。 
C  の 関数 ►  Key  *  KMInit  (long  buf  len) ; 

返り 値は キー マ ンレ コー ドへの ポインタ。 


$A0A0  KMTini 


引 数 ►  long  kmRecPtr  ; キー マン レコー ドへの ポインタ 

返り 値 ►  なし 

機 能  >  キーマンの 終了 処理を 巧う。 

C の 関数 ►  void  RMTiniCKey  *kmRecPtr) ; 

返り 値は ない。 


$A0A1  KMCurKmrGet 


引 数- なし 

返り 値 ►  D0.L  キー マン レコードへの ポインタ 
機 能 ►  キーマン レコードへの ポインタを 返す。 
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キーマン 


C の 関数 ►  Key  *KMCurKmrGet (void) ; 

返り 値は キーマン レコ ー ドへの ポイ ンタ。 
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イベント マン 


イ ベン b スン 


#include  〈EVENT. H> 


$A0A2  EMInit 


引数- なし 
返り 値 ►  なし 

機 能 >  イベント マンを 初期化す る。 

イベント キュー、 割り込み ルーチンが 初期化 される。 
C  の 関数 ►  void  EMInit  (void) ; 

返り 値は ない。 


$A0A3  EMTini 


引数- なし 

返り 値 ►  DO.L  リザ ル トコード 
機 能 ► イベント マンの 終了 化理を 行う。 

割り込み ルーチンを 開放し、 ベクタを 元に 戻す。 
C の 関数 ►  void  EMTini  (void) ; 

返り 値は ない。 


$A0A4  巨  MSet 


引 

数 ► long 

what 

; 発生させる イベントの イベント コ 

long 

whom 

; イベント にか 随 する 情報 

返り 値 DO.L 

リ ザル トコ ー ド 

機 

能 ►  what で 指定した イ ベン トをイ 

ベント キューに 登録す る。 

イ ベン トコー ドと それに 付随す る 情報の 内容は] a 下のと おり。 


イ ベン h マン 


イベント コ ー ド 

イ ベン トじ 付随す る 情報 

0  :  E-IDLE 

E_IDLE イ ベン トを 発生させる ことは できない 

1 : E_MSLD0WN 

0 

2  :  E_MSLUP 

0 

3  :  E_MSRD0WN 

0 

4  :  E-MSRUP 

0 

5  :  E_KEYD0WN 

上位 ヮー ド： キー コード、 下位 ヮー ド： ASCII コード 

6  :  E_KEYUP 

上位 ヮー ド： キー コード、 下位 ヮー ド： ASCII コード 

7  :  E-UPDATE 

ウイン ドウ レコー ドへの ポイ ンタ 

9  :  E-ACTIVATE 

ウインドウ レコー ドへの ポイ ンタ 

12  :  E_SYSTEM1 

イ ベン ト マンの 管理 外 （タスク マンが 管理す る） 

13  :  E_SYSTEM2 

イ ベン ト マンの 管理 外 （タスク マンが 管理す る） 

14  :  E.SYSTEMS 

イ ベン ト マンの 管理 外 （タスク マンが 管理す る） 

15  :  E_SYSTEM4 

イ ベン ト マンの 管理 外 （タスク マンが 管理す る） 

C の 関数 ►  int  EMSet (int  what , 1011 居  whom) ; 
返り 値は リ ザル ト コード。 


$A0A5 


EMGet 


扭 ask  ; イベント マスク 

eventRecPtr  ; イベント レコー ドへの ポイ ンタ 

=0  イベントは 得られなかった 

丰。  イベントを 得る ことができた 

イ ベン ト キューから 皿 ask の 各ビッ トで 指定した イ ベン トを 取り 化し、 削除す 
る。 取り出 した イ ベン トの 内容は eventRecPtr で 指定した イ ベン ト レコー ド 
じ 返る。 

C  の 関数 ►  BOOLEAN  EMGet  (int  皿  ask,  Event  *eventRecPtr) ; 

返り 値は イ ベン ト 取り出しの 成否。 


引 

数 

word 

long 

返り 値 ► 

DO.L 

獻 

の 

能- 

イ ベン 

$A0A6 


EMScan 


引 数 


返り 値- 


機 能 I 


word 

long 

DO.L 


皿 ask  ; イベント マスク 

eventRecPtr  ; イベント レコ ー ドへの ポイ ンタ 

=0  イベントは 発見で きなかった 

丰り  イベントを 発見で きた 

イベント キュー から mask の 各ビッ ト です 旨定 した イ ベントの うち、 イベント キュー 
のなか で 最初 に 見つかった ものを 参照 する。 イベントの 内容は event  Re  cPtr 
で 指定した イベント レコードに 返る。 

C の 関数 ►  int  EMScan  (int  mask,  Event  *eventRecPtr) ; 

返り 値は イ ベン ト 参照の 成否。 
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$A0A7  EMMSLoc 


引数 なし 

返り 値 ►  D0.L  マウス 位置を 示す ポイント （口一々 ル 座標）/ リザ ル トコード 

機 能 ►  マウスの 座標を 返す。 

あらかじめ カレン ト グラフ レコードを セット して おく 必要が ある。 

C の 関数 ►  LPoint  EMMSLoc  (void) ; 

返り 値は マウスの ローカル 座標を 意味す る ポイント。 


$A0A8  EMLBttn 


引数- なし 

返り 値- D0.L  =0  押されて いない 

丰り  押されて いる 

機能 ►  マウスの 左 ボタンの 状態を 返す。 

C の 関数 ►  BOOLEAN  EMLBttn  (void) ; 

返り 値は 左 ボタンの 状態。 


$A0A9  EMRBttn 


引 数  >  なし 

返り 値 ►  D0.L  =0  押されて いない 

丰。  抑され ている 

機 能  >  マウスの 右 ボタンの が 態を 返す。 

C の 関数 ►  BOOLEAN  EMRBttn  (void) ; 

返り 値は 右 ボタンの が 態。 


$A0AA  EMLStill 


引数- なし 

返り 値 ►  D0.L  =0  押された ままでは ない 

幸。  押された まま 

機 能 ►  マウスの 左 ボタン が 押 された まま かどう かを 調べる。 
C の 関数 ►  BOOLEAN  EMLStiii(void) ; 

返り 値は 左 ボタンの が 態。 


$A0AB  EMRStill 
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イベント マン 


返り 値 ►  DO.L  =0  押された ままでは ない 
丰り  押された まま 

機 能 >  マウスのを ボタンが 押された まま かどう かを 調べる。 
C の 関数 ►  BOOLEAN  EMRStilKvold) ; 

返り 値は 右 ボタンの 状態。 


$A0AC  EMLWait 


引 数  >  なし 

返り 値 ►  D0.L  =0  押された ままでは ない 
幸。  押された まま 

機 能 ►  マウスの 左 ボタンが 押された まま かどう かを 調べ、 離されて いれば 離された 時 
点で 登録 さ れた E-MSLUP イベントを 取り除く。 

C の 関数 ►  BOOLEAN  EMLWait  (void) ; 

返り 値は 左 ボタンの 状態。 


$A0AD  EMRWait 


引 数- なし 

返り 値 ►  D0.L  =0  押された ままでは ない 

牛。  押された まま 

機 能 ►  マウスの 右 ボタンが 押された まま かどう かを 調べ、 離されて いれば 離された が 
点で 登録 さ れた E_MSRUP イベントを 取り除く。 

C の 関数 ►  BOOLEAN  EMRWait  (void) ; 

返り 値は 右 ボタンの が 態。 


$A0AE  区 MKMapGet 


引 数 ► long  kmapBuf  ; キー マップが 返る バッファの アドレス 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  kmapBuf で 指定され た 128 バイトの バッファに、 キーマップの 内容を コピー 
する。 

C の 関数 ►  void  EMKMapGet ( char  本 幸 km ろ pBuf  ) ; 

返り 値は ない。 


$A0AF  EMSysTime 


引 数 ►  なし 

返り 値 ►  D0.L  システム 時間 
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機能 >  現在の システム 時間 （1/100 秒 単位） を 返す。 
C の 関数 ►  unsigned  long  EMSysTime (void) ; 
返り 値は システム 時間。 


$A0B0  EMDClickGet 


引数- なし 

返り 値 ►  D0.L  ダブル クリ ック 基準 時間 （1/100 秒 単位) 

機 能 ►  設定され ている ダブル クリ ック 基準 時間を 返す。 

C の 関数 ►  unsigned  long  EMDClickGet  (void); 

返り 値は ダブル クリッ ク 基準 時間。 


$A0B1  EMBlinkGet 


引 数- なし 

返り 値 ►  D0.L  々ーソ ル 点滅 基準 時間 (1/100 秒 単位) 

機能- 設定され ている々 ー ソル 点滅 基準 時間を 返す。 

C の 関数 ►  unsigned  long  EMBlinkGet  (void) ; 

返り 値は々 ーソ ル 点滅 基準が 間。 


$A0B2  EMClean 


引 数 ►  word  皿 ask  ; 削除す る イベントを 示す イベント マスク 

word  sMask  ; 削除を 終了す る イベントを 示す イベント マ 

スク 

返り 値 ►  D0.L  リザルト コード 

機能 ► イ ベン ト キューの なかで mask の 各ビッ トで 指定した イ ベン トを 削除す る。 

sMask の 各 ビットで 指ました イベントを 発見した 時点 で 削 除を 終了す る。 

C の 関数 ►  int  mask,  int  sMask) ; 

返り 値は り ザル トコ ー ド。 


$A0B3  EMMaskSet 


引 数 ►  word  mask  ; イベント マスク 

返り 値 ■-  なし 

機 能- $A0A4  EMSet で イベントを 登録す る 際に 参照され る、 登録で きる イベントを 
制限す るた めの マスクを mask で 指定す る。 立って いる ビッ トに 対応す るイべ 
ン ト のみ 登録 可と なる。 
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C の 関数 ►  void  EMMaskSet (int  mask) ; 
返り 値は ない。 


$A0B4  EMDTTskSet 


引 数 ► long  TTskAdr  ; ユーザ 背景 描画 ルー チンの アドレス 

返り 値 >  なし 

機能 ►  SX-WINDOW  ver.3.0  1U 降からは 使用で きない コー ル。 

背景 書き換え 時に 呼び出される ユーザ ルー チンを 登録す る。  0 を 指定す ると 
何も しないよう になる。 


$A0B5  EMDClickSet 


引 数 ► long  clickTime  ; ダ ブルクり ッ ク 基準 時間 （1/1〇〇 単位） 

返り 値 >  なし 

機能  >  ダブル クリック の 基準 時閒を clickTime じ 設定す る。 

C の 関数 ►  void  EMDClickSet (\ms igned  long  clickTime) ; 

返り 値は ない。 


$A0B6  EMBlinkSet 


引 数 long  blinkTime  ; 力ーソル 点滅 基準 時間 （1/100 単位） 

返り 値 >  なし 

機能 >  力ーソル 点滅の 基準が 閒を blinkTime に 設定す る。 

C  の 関数 ►  void  EMBlinkSet  (unsigned  long  blinkTime); 

返リ 値は ない。 


$A0B7  EMEnCross 


引 数 ►  word  d  ; つねに 0 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  マウス ポインタを 路 切々ー ソル じする。 

C の 関数 ►  int  EME 打 Cro が （void) ; 

引数と して 0 を 与える 必耍 はない。 

返り 備はリ ザル トコード。 
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$A0B8  EMDeCross 


引数 ►  なし 

返り 値 ►  D0.L  リ ザル トコー ド 
機 能- マウス ポインタを 元に 戻す。 
C の 関数 ►  int  EMDeCross(void) ; 
返り 値は リ ザル トコ ー ド。 
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リソース マン 


#include  〈RESOURCE. H> 


$A0D9 

RMInit 

引 数- 

なし 

返り 値 ► 

なし 

機 能- 

リ ソース マンを 初期化す る。 

SX シェル 上で 動作す る プログラムは、 

これを 呼び出して はならない。 

C の 関数 ► 

int  RMInit  (void) ; 

返り 値は 意味を 持たない。 

$A0DA 

RMTini 

引 数- 

なし 

返り 値 ► 

なし 

機 能 > 

リ ソース マンの 終了 処理を 斤う。 

SX シてル 上で 動作す る プログラムは、 

これを 呼び出して はならない。 

C の 関数 > 

void  RMTini  (void) ; 

返り 値は ない。 

$A0DB 

RMResNew 

引数- なし 

返り 値 ►  D0.L  リザルト コード 

AO.L  リ ソー スマップへの ハン ドル 

機能 ►  新しい リ ソース マップを メモリ 上に 作成す る。 

実際に ファイル が 作成 される わけでは ない。 
作成 直後の リソース マップの 内を は 空で ある。 
巧 配 蘆が 発生す る。 

C の 関数 ►  Handle  RMResNew (void) ; 

返り 値は リ ソー スマップへの ハン ドル。 

負の 値の 場合は リ ザル ト コード。 
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$AODC 


RMRscAdd 


引 数- 


返り 値 ► 


機能* 


long 

word 

long 

long 

DO.L 

AO.L 


追加す るリ ソースの タイプ 
追加す るリ ソース ID 
追加す るリソ ー ス への ハン ドル 
追加す るリ ソースの サイズ 


Type 
ID 
h 

Size 

リザルト コ ー ド 
新しい リ ソース への ハン ドル 
々レントの リ ソース マップに リ ソースを 追加す る。 

リ ソースは、 リ ソース マンが 新しく 髓 保した ブロック じ コピー される。 

疑似 ハンドル も 可。 再 配讀が 発生す る。 

C  の 関数 ►  -Handle  RMRscAdd  (long  Type ,  int  ID, —Handle  11,101 ig  Size) 

返り 値は 新しい リ ソース への ハン ドル。 

負の 値の 場合は リ ザル トコ ー ド。 


$AODD 


RMRscR  色  niov  色 


; 削除す るリ ソースの タイプ 
; 削除す るり ソース ID 


引 数 ► long  Type 

word  ID 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 >  Type と ID で 指定したり ソース を、 カレント リソース マップから 削除す る。 
再 配證が 発生す る。 

C の 関数 ►  int  RMRscRemove ( 1 ong  Type,  int  ID); 

返り 値は リ ザル ト コード。 


$AODE 


RMTypeRemove 


弓 I 数 ► long  Type  ; 削除す るリ ソース 群の タイプ 

返り 値 ►  DO.L  リザ ル トコード 

機 能 ►  カレント リソース マップの、 Type で 指を する タイプの リソース 群を すべて 削 
除す る。 

巧 配 蘆が 発生す る。 

C の 関数 ►  int  RM TypeRem ove (long  Type) ; 

返り 備はリ ザル トコ ー ド。 


$AODF 


RMResDispose 
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引 数 なし 
返り 値 ►  DO.L 


リ ザル トコー ド 
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機 能 ►  々レント リソー スマップを メモリから 削除す る。 オープン 中であった 場合で も 
クローズ しない。 

再配置が 発生す る。 

C の 関数 ►  int  RMResDispose(void) ; 

返り 値は リ ザル トコ ー ド。 


$AOEO  RMResOpen 


引 数*" long  Name  ; リソース ファイル 名 

返り 値 ►  D0.L  リザ ル トコー ド 

A0.L  リ ソー スマップへの ハン ドル 

機 能 ►  Name で 指定した リソース ファイルを オープンして、 々レントと する。 この 時 
点では、 リソース マップの みが 読み込まれ、 ファイルは オープン 状態の ままで 
ある。 

再配置が 発生す る。 

C の 関数 ►  Handle  RMResOpeniconst  char  *Naine) ; 

返り 値は リ ソース マップへの ハン ドル。 

負の 値の 場合は リ ザル トコ ー ド。 


$A0E1  RMRscGet 


引 

数 

long 

Type 

word 

ID 

返り 値 

DO.L 

リ ザル トコード 

AO.L 

リ ソース への ハン ドル 

機 

能- 

Type と ID で 指定した リソ ース？ 

;Get したい リ ソースの タイプ 
;Get したい リ ソース ID 


再配置が 発生す る。 

SX-WINDOW  ver.3.0 な 降では、 タスク マンが この コー ルを フックして、 ロー 
カルリ ソース 対応して いる。 


C の 関数 ►  -Handle  RMRscGet ( 1 ong  Type ,  int  ID) ; 
返り 値は リ ソースへの ハン ドル。 


$A0E2  RMResClose 


引 数 ► long  Name  ; ファイル 名 

返り 値 ►  DO.L  リ ザル トコー ド 

機 能 ►  々レン トリ ソース マップと その 下の リ ソース 群を Name で 指定した ファイル じ 
セー ブ して、 メモリから 削除す る。 々レントは 次の リソース マップに 移る。 

西 配 鼠が 発生す る。 
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C の 関数 ►  int  说 VlResC 70 se(const  char  *Name) ; 
返り 値は リ ザル トコー ド。 


$A0E3  RMResRemove 


引 数 なし 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  カレント リソース マップと その 下の リソース 群を メモリから 削除す る。 オー プ 
ン 中の 場合は クローズ する。 カレン トは 次の リ ソース マップに 移る。 

再配置が 発生す る。 

C  の 関数 ►  int  RMResRemove  (void) ; 

返り 値は リ ザル トコ ー ド。 


$A0E4  RMCurResSet 


引 数 ►  long  ResMap  ; リソー スマップの ハンドル 

返り 値 ►  AO.L  前の々 レン トリ ソース マップの ハン ドル 
機能 ►  ResMap で 指定した メモリ 中の リ ソース マップを々 レン トに する。 
C の 関数 ►  Handle  RMCurResSet (Eandle  ResMap) ; 

返り 値は 前の カレン トリ ソース マップの ハン ドル。 


$A0E5  RMRscRelease 


引 数 ► long  Rsc  ; 民 elease する リソ ースの ハンドル 

返り 値 ►  DO.L  リ ザル トコ ー ド 

AO.L  ハンドルが そのまま 返る （エラーの 場合は 0) 

機 能 ►  Rsc で 指定した リソースを リソース マンの 瞥理 から 外し メモリから 削除す る。 
再配置が 発生す る。 

C の 関数 ►  int  RMRscRelease ( _Haiidl e  Rsc) ; 

返り 値は リ ザル トコ ー ド。 


$A0E6  RMRscDetach 


引 

数- 

long 

Rsc  ;Detach する リソースの ハンドル 

返り 値 ■- 

DO.L 

リ ザル トコ ー ド 

AO.L 

ハンドルが そのまま 返る （エラーの 場合は 0) 

機 

能 > 

Rsc で ネ旨定 した リ ソースを リ ソース マンの 瞥理 から 外す。 メモ リ からは 削除し 

ない。 

再配置が 発生す る。 
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C の 関数 ►  int  RMRscDetach ( .Handle  Rsc) ; 
返り 値は リ ザル トコ ー ド。 
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$A0E7  RMMaxIDGet 


引数 long  Type  ; 最大 ID を 調べる タイプ 

返り 値 ►  D0.L  Type の 最大 ID/ リザ ル トコー ド 
機能 Type で 指定した リ ソース 群の なかで 最大の ID を 返す。 

C の 関数 ►  int  RMMaxIDGet ( 1 ong  Type) ; 

返り 値は Type の 最大 ID/ リ ザル トコ ー ド。 


$A0E8  RMResSave 


引 数 ►  10 丘 良  Name  ; リソー スフ ァイ ル 名 

返り 値 ►  DO.L  リザルト コード 

AO.L  リ ソースファイル 名が そのまま 返る 

機 能 ►  々レン トリ ソース マップと その 下の リ ソース 群を Name で 指定した ファイルに 
セーブす る。 メモリから 削除し ない。 々レント リソース マップは 変更され ない。 
再 配 蘆が 発生す る。 

C の 関数 ►  int  RMResSave  (const  char  *Name) ; 

返り 値は リ ザル トコ ー ド。 


$A0E9  RMHdlToRsc 


引 数 ► long  Rsc  ; リソー スマップを 得る リソ ース への ハンドル 

返り 値 ►  DO.L  リソース マップへの ハンドル 

機 能 ► リソース マン 用。 

Rsc で 指定した リ ソース が 所属す るリ ソー スマップの ハン ドルが 返る。 

C の 関数 ►  Handle  RMHdlToRsc ( -Handle  Rsc) ; 

返り 値は リ ソース マップへの ハン ドル。 


$AOEA  RMCurResGet 


引 数 なし 

返り 値 ►  DO •  L  々レント リソ ー スマ ッ プ への ハン ドル 
AO.L  々レン トリ ソース マップへの ハン ドル 

機 能 ►  カレント リソース マップへの ハンドルを 返す。 

C の 関数 ►  Handle  RMCurResGet  (void) ; 

返り 値は カ レン トリ ソース マップへの ハン ドル。 
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$AOEB 


RMLastResGet 


引数- なし 

返り 値 ►  DO.L  最終 リソース マップへの ハンドル 

AO.L  最終 リ ソース マップへの ハン ドル 

機 能 ► 最終 リ ソー スマップ （蹤 後に オープンされ たリ ソース マップ） への ハン ドルを 
返す。 

C の 関数 ►  Handle  RMLastResGet  (void) ; 

返り 値は 最終 リ ソース マップへの ハン ドル。 


$AOEC 


RMResLoad 


引数 なし 

返り 値 ►  D0.L  リ ザル トコー ド 

機 能 ►  カレント リソース マップの 下の リソースを、 すべて 読み込んで メモリに 蘆く < 
ファイルは クローズ される。 

再配置が 発生す る。 

C の 関数 ►  int  RMResLoad  (void); 

返り 値は リザ ル トコー ド。 


$A0ED 


RMResLinkGet 


引 数 ►  long  Res  Map  ; リソース マップへの ハンドル 

返り 値 ►  D0.L  次の リソース マップへの ハンドル 

機 能 ► 指定した リソース マップの 次' の リソース マップを 得る。 

C の 関数 ►  Handle  RMResLinkGet  (Handle  ResMap) ; 

返り 値は 次の リ ソー スマップへの ハン ドル。 


$A0EE 


RMResTypeList 


引 数 • 


返り 値 ► 
機能 > 


； タイプの 数 力ぶ 返る バッファ （1 ロング ヮー ド） 
の アド レス 

; タイプの リスト （タイプの 数 X 1 ロング 
ワー ド） への ハン ドルが 返る バッファの ア 
ドレス 

； リソース マップへの ハンドル 


す旨定 した リ ソース マップに 發録 されて いる タイプの 数と リス トを 得る。 


long 

argc 

long 

argv 

1011 呂 

ResMap 

DO.L 

=  0 

正常終了 

丰り 

エラ- 
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リストは、 タイプ 名 （1 ロング ワー ド） が タイプの 数 だけ 並んで いる 構造で、 巧 
配置 可能 ブロック として 作成され る。 末尾は 0 •し リストが 不要に なったら、 
廃棄す る 必要が ある。 

再配置が 発生す る。 

C の 関数 ►  int  RMResTypeList ( int  *argc , long  ***argv, Handle  ResMap) ; 
返り 値は 結果を 意味す る 数値。 


$A0EF  RMResIDList 


引数 ► long 

argc 

; ID の 数 力 《返る バッファ （1 ロング ワー ド） の 
アドレス 

long 

argv 

; ID の リスト （ID の 数 X 1 ワード） への ハ 
ン ドル カ ぶ 返る バッファの ア ドレス 

long 

ResMap 

; リソー スマップへの ハンドル 

long 

Type 

; タイプ 

返り 値 ►  DO . L 

=  0 

丰り 

正常終了 

エラー 

機 能  >  指定した リ ソース マップに 登録され ている タイプの の の 数と リス トを 得る。 

リストは の （1 ワード） が の の 数 だけ 並んで いる 構造で、 再配置 可能 ブロック 
として 作成され る。 末尾は 0.W。 リストが 不要に なったら、 廃棄す る 必要が あ 
る 0 

再配置が 発生す る。 

C の 関数 ►  int  RMResIDList ( int  *argc,  short  ***argv， Handle  ResMap, 
long  Type); 

返り 値は 結果を 意味す る 数値。 
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#include  <SXGRAPH.H> 


$A12D  GM 曰 pe 打 Graph 


引 

数 

word 

scrTvDe  ; 

初期化す る グラフ レコ ー ドの タイプ 

long 

graphPtr  ; 

グラフ レコー ドへの ポイ ンタ 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

グラフ レコー ドへの ポイ ンタか •返る 

機 

能- 

GraphPtr で 指定した グラフ レコ 

ー ドを、 scrType で 指定した タイプの グラ 

フ レコード として 初期化し、 々レントに する。 

グラフ レコードの メンバで ある bitmap のた めの リージョン レコードを 再 配 
置 不能 ブロック として 作成す る。 

疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMOpenGraph ( int  scrType,  Graph  *graphPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A12E  GMCloseGraph 


引 数 ►  long  graphPtr  ; グラフ レコード への ポイ ンタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

A0.L  グラフ レコー ドへの ポイ ン タカ、* 返る 

機 能 ■-  graphPtr で 指定した グラフ レコー ドを クロー ズ する。 

グラフ レコ _ ドの メ ンバ であった 各種 リージ ョ ンレ コー ドが 占めて いた ブロ ッ 
クは 廃棄され る。 

疑似 ポイ ンタも 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMC 70 seGra が 1( Graph  *graphPtr) ; 

返り 做は リ ザル トコ ー ド。 


$A130  GMInitGraph 


引 

数 

long 

graphPtr  ; グラフ レコー ドへの ポインタ 

返り 値*^ 

DO.L 

リ ザル トコー ド 

AO.L 

グラフ レコー ドへの ポイ ンタ か •返る 

機 

能- 

GrauhPtr 

で 指定 した グラフ レコードを 初期化す る。 
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グラフ レコ ー ドの メ ンバ である ビジ ブルリ ー ジョン、 クリ ッ プリ ージョ ンの 
ためのりー ジョ ンレ コー ドを 再配置 可能 ブロックと して 作成す る。 $A12D 
GMOpenGraph を 実行した あとに 使用す る こと。 

疑似 ポイ ンタも 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMInitGraph (Graph  幸 graphPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A131  GMSet Graph 


引 数 ► long  graphPtr  ; グラフ レコー ドへの ポインタ 

返り 値 ►  DO.L  リ ザル トコ ー ド 

A0.L  グラフ レコ ー ドへの ポイ ンタ 

機 能 ►  graphPtr で 指定した グラフ レコードを カレントに する。 

疑似 ポイ ンタも 可。 

C の 関数 ►  int  GMSetGraph (Graph  *graphPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A132  GMGet Graph 


引数 なし 

返り 値 ►  D0.L  =0 

A0.L  々レン ト グラフ レコードへの ポイ ンタ 

機 能 ►  現在の カレント グラフ レコードへの ポインタを 返す。 
C  の 関数 ►  Graph  *  GMGet  Graph  (void) ; 

返り 値は グラフ レコ ー ドへの ポイ ンタ。 


$A133  GMCopyGraph 


引 数 


返り 値 


機 能 


long  dstGraphPtr  ; コピー 先の グラフ レコードへの ポインタ 

long  srcGraphPtr  ; コピー 元の グラフ レコー ドへの ポインタ 

D0.L  リ ザル トコ ー ド 

A0.L  コ ピー 先の グラフ レコ ー ドへの ポイ ンタが 返る 

srcGraphPtr で 指定した グラフ レコードの 内容を、 dstGraphPtr で 指定 
した グラフ レコードに コピーす る。 dstGraphPtr 用の、 ビットマップ レコ ー 
ド、 ビジ ブル リージョン、 クリップ リージョン、 各リー ジョン レコー ド 用の ブ 
ロック も 作成す る。 すでに 各リ ージョ ンレ コー ド 用の ブロックが 作成され てい 
て、 メンバと して 登録され ていた 場合には、 その 廃棄は 行われない。 

疑似 ポイ ンタ 可。 
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再配置が 発生す る。 

C の 関数 ►  int  GMCopyGraph  (Graph  *dstGraphPtr ,  Graph  *srcGraphPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A136 

GMMoveGraoh 

引 数- 

long  pt 

; グラフ レク タング ルを 移動させる ポイント 

返り 値 

DO.L  =0 

(絶が 位置） 

AO.L  カレント グラフ レコー 

ドへの ポイ ンタ 

機 能- 

カレント グラフ レコードの グラフ レク タング ルの 座標を グロー バル 座標系での 
pt の 位舊じ 移動させる。 グラフ レク タング ルの 大きさは 変化し ない。 

C の 関数 ►  void  GMMoveGraph (LPoint  pt) ; 

返り 値は ない。 

$A137 

GMSlideGraph 

引 数- 

long  pt 

; グラフ レク タング ルを 移動させる ポイント 

返り 値 

DO.L  =0 

(相対 位證） 

AO.L  々レント グラフ レコー 

ドへの ポイ ンタ 

機能- 

々レント グラフ レコー ドの グラフ レク タング ルの 座標を グロー バル 座標系での 
pt で 示された 値 だけ 相対 移動させる。 グラフ レク タング ルの 大きさは 変化し 

ない。 

C の 関数- 

void  GMSlideGraph  (LPoint  pt) ; 

返り 値は ない。 

$A138 

GMSetClip 

引 数 ►  long  rgnHdl  ; リー ジョン レコー ドへの ハンドル 

返り 値 ►  D0.L  リザルト コード 

A0 .  L  り ー ジョン レコ ー ド への ハンド ルが 返る 

機 負 長 ►  々レント グラフ レコー ドの クリップりー ジョンに、 rgnHdl で 指定 したりー ジョ 
ン をセッ ト する。 

スク リプト に 記録され る。 

疑似 ハン ドル も 可。 

稱 配置が 発生す る。 

C の 関数 ►  int  GMSet Clip  (Region  **rgnHdl) ; 

返り 値は リ ザル トコ ー ド。 
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$A139  GMGetClip 


引 数 ►  long  rgnHdl  ; リージョン レコー ドへの ハンドル 

返り 値 ►  D0.L  リ ザル トコ ー ド 

A0.L  リー ジョン レコー ドへの ハン ドルが 返る 

機能 々レント グラフ レコードの クリップ リージョンの 内容を rgnHdl で 指定した 
リージョン レコ ー ドに 返す。 

再配置が 発生す る。 

C の 関数 ►  int  GMGetGfip (R%ion  **rgnHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A13A  GMClipRect 


引 数 ►  long  rectPtr  ; レク タング ルレ コードへの ポインタ 

返り 値 ►  DO.L  リ ザル トコー ド 

機 能 ►  々レント グラフ レコードの クリップ リー ジョン じ、 rectPtr で 指定した レク 
タング ルを セッ ト する。 

疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMClipRect ( Re c t  れ ectPtr) ; 

返り 値は リザ ル トコ ー ド。 


$A13B  GMSetHome 


引 数 ► long  homePt  ; ホー ム 位置を 示す ポイント 

返り 値*-  D0.L  リザルト コード 

機 能 ►  々レント グラフ レコードの ホーム 位置を 口一々 ル 座標系の pt じする。 これに 
よって 設定した ホーム 位置は、 グラフ レコ ー ド 内の ビッ ト マップ レク タング ル、 
グラフ レク タング ル、 ビジ ブル リージョンに 反映す る。 

C の 関数 ►  int  GMSetHome ( LP 〇 int  HomePt) ; 

返り 値は リ ザル トコ ー ド。 


$A13C  GMSetGraphSize 


引 勢  >  long  sizePt  ; サイズを 指定す る ポイント 

返り 値 ►  DO.L  リ ザル トコー ド 

機 能 ►  々レント グラフ レコードの グラフ レク タング ルの 大きさを、 sizePt で 指定し 
た （x，y) の サイズに を更 する。 （x，y) のど ちらかが 0 じ I 下に なった 場合、 々レン 
ト グラフ レコ ー ドの グラフ レ クタ ン グルは ヌ ルレ クタ ン グルと なる。 
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C の 関数 ►  int  GMSe t GraphSize ( LP o int  sizePt) ; 

返り 値は リ ザル トコ ー ド。 


$A13D  GMSetBitmaD 


引 数 ►  long  bitmapPtr  ; ビットマップ レコードへの ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  カレント グラフ レコー ドに、 bitmapPtr で 指定 した ビッ ト マップ レコードを 
セッ ト する。 

疑似 ポイ ンタも 可。 

SX-WINDOW  ver.3.0 じ I 降からは スクリプト じ 記録され ないよう じ なった。 

C の 関数 ►  int  GMSetBi tmapiBi t map  ♦bitmapPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A13E  GMLocalToGlobal 


引 数 ► long  pt  ;  ローカル 座標系の ポイント 

返り 値 ►  D0.L  グローバル 座標系に 変換した ポイント 

A0.L  々レント ビット マッ プ ポインタ 

機 能 ►  pt で 指定した 口ー カル 座標系の ポイントを、 グローバル 座標系に 変換して 返す。 
C の 関数 ►  LPoint  GMLocalToGlobaliLPoint  pt) ; 

返り 値は グローバル 座標を 惠味 する ポイント。 


$A13F  GMGlobalToLocal 


引 数 ► long  pt  ; グローバル 座標系の ポイント 

返り 値 ►  D0.L  ローカル 座標系に 変換した ポイント 

A0.L  々レント ビッ ト マップ ポイ ンタ 

機 能 ►  pt で 指定した グローバル 座標系の ポイントを、 口ー カル 座標系に 変換して 返す。 
C  の 関数 ►  LPoint  GMGlobalToLocal  (LPoint  pt) ; 

返り 値は ローカル 座標を 意味す る ポイント。 


$A140  GMInitPen 


引 数 ►  なし 
返り 値 ►  なし 

機 能 ►  々レント グラフ レコードの ペンを 初期化す る。 
スク リプト じ 記録され る。 

これに よって 初期化 された ペンは、 
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• ペン モードは pset 
• ペン サイズは 縦し 横 1 
• ペン パターンは 塗りつぶし 

という 状態になる。 

C の 関数 ►  void  GMInitPen(void) ; 
返り 値は ない。 


$A141  GMPenShow 


引数- なし 

返り 値 ►  DO.L  変更 後の ドロー  レベル 


0 

HIDE 

1 

HOW 

A0.L  々レント グラフ レコー ドへの ポイ ンタ 
機 能 ►  々レント グラフ レコー ドの ドロー レ ベルを +1 する。 
C の 関数 ►  BOOLEAN  GMPenShowivold) ; 

返り 値は 変更 後の ドロー  レベル。 


$A142  GMPenHide 


引数- なし 

返り 値 ►  DO.L  変更 後の ドロー  レベル 


0 

HIDE 

1 

SHOW 

A0.L  々レント グラフ レコー ドへの ポイ ンタ 
機 能 ►  々レント グラフ レコー ドの ドロー レベルを 一1 する。 

C  の 関数 ►BOOLEAN  GMPenHide(vo±d) ; 

返り 値は 変更 後の ドロー  レベル。 


$A143  GMPenSize 


引 数 ► long  sizePt  ; ペン サイズを 指定す る ポイント 

返り 値 ►  DO.L  前の ペン サイズを 示す ポイント 

機能 ►  カレント グラフ レコードの ペン サイズを SizePt で 指ました （x，y) サイズに 変 
更 する。 

スク リプト に 記録され る。 

C の 関数 ►  LPoint  GMPenSize ( LP 〇 int  sizePt) : 
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返り 値は 前の ペン サイ ズを 意味す る ポイント。 


$A144  GMPenMode 


引 数 ►  word  皿 ode  ; ペン モード 


上位 バイト 

0 

フォア グラウン ド々 ラーで 描圃 

1 

バックグラウンド々 ラーで 描圃 

2 

ペン パタ ーンで 描画 

3 

ェク ステン ド パ ターン で 描画 

下位 バイト 

0 

pset 

1 

and 

2 

or 

3 

xor 

4 

npset 

5 

Hand 

6 

nor 

7 

nxor 

(じ1 下は、 グラフィック タイプの ビ 
ッ ト マップに のみ 有効） 


返り 値 ►  D0.W  前の ペン モ _ ド 

機 負^ ►  カレント グラフ レコー ドの ペン モー 
スク  リプト  に 記録され る。 

C の 関数 ►  int  GMPenMode ( int  mode) ; 
返り 値は 前の ペン モー ド。 


$A145  GMPenPat 


引 数 ►  long  DatPtr  ; ペン パ ターン への ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

AO.L  前の ペン パ ターン への ポイ ンタ 

機 能 ►  々レント グラフ レコー ドの ペン パ ターン を patPtr で 指定した ペン パ ターン 
に 変更す る。 

スク リプト に 記録され る。 

疑似 ポイ ンタも 可。 


8 

add 

9 

add  limit 

10 

sub 

11 

sub  limit 

12 

select  max 

13 

select  田 in 

14 

blend 

ドを 皿 ode じ 変更す る。 
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C の 関数 ►  unsigned  short  * GMPenPat (uns igned  short  *patPtr) ; 
返り 値は 前の ペン パターンへの ポイ ンタ。 


$A146  GMExPat 


引 数 ►  long  patPtr  ; エ クス テン ド パターンへの ポインタ 

返り 値- D0.L  リザルト コード 

機 能 ►  々レント グラフ レコードの エク ステン ド パターンを patPtr で 指を した エク 
ステン ド パターンに 変更す る。 

スク リプト に 記録され る。 

疑似 ポインタ も 可。 

C  の 関数 ►  unsigned  short  *  GMExPat  (uns  igned  short  *patPtr) ; 

返り 値は 前の ェク ステン ド パ ターン への ポイ ンタ。 


$A147  GMForeColor 


引 数 ►  word  color  ; 々ラー コード 

返り 値 ►  D0.W  前の フォアグラウンド カラー コード 

機 能 ►  々レント グラフ レコー ドの フォアグラウンド々 ラー を color に 変更す る。 

スクリプトに 記録され る。 

C の 関数 ►  int  GMForeColor ( int  color) ; 

返り 値は 前の フォアグラウンド々 ラー コード。 


$A148  GMBackColor 


引 数 ►  word  color  ; 々ラー コード 

返り 値 ►  D0.W  前の バックグラウンド カラー コード 

機 能 ►  々レント グラフ レコードの バックグラウンド々 ラーを color に 変更す る。 

スク リプト に 記録され る。 

C の 関数 ►  int  GMBackColor ( int  color) ; 

返り 値は 前の バックグラウンド々 ラー コー ド。 


$A149  GMAPage 


引 数 ►  word  aPa_ge  ; テキスト V 民 AM への アクセス モード 

返り 値 ►  DO.W  前の アクセス モード 

機 能 ►  々レント グラフ レコー ドの ビットマップの アクセス モー ドを aPage じ 変更す 
る。 テキスト タイプの グラフ レコード じの み 有効。 

スク リプト に 記録され る。 
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C の 関数 ►  int  GMAPage (int  aPeige) ; 
返り 値は 前の アクセス モー ド。 


$A14A  GMGetLoc 


引 数 なし 

返り 値 ►  D0.L  現在の ペン 位置を 示す ポイント 

機能 ► カレント グラフ レコードの ペン 位置を ローカル 座標系で 返す。 

C  の 関数 ►  LPoint  GMGetLoc  (void) ; 

返り 値は 現在の ペン 位置を 意味す る ポイント。 


$A14B  GMGetPen 


引 数 ► long  bufPtr 
返り 値 ►  (buf Ptr+$00)  •  L 
(bufPtr+$04) .L 
(bufPtr+$08) .W 


; 情報が 返る バッファへの ポインタ 
ペン 位置を 示す ポイント 
ペン サイズを 示す ポイント 
ペン モード 


(bufPtr+$0A)  .L  ペン パターンへの ポイ ンタ 
機 能 ►  カレント グラフ レコー ドの ペン 関係の 情報を まとめて 返す。 バッファは 14 バイ 


卜 必要。 

疑似 ポインタ も 可。 

C の 関数 ►  void  GMGetPen  (Pen  *buf  Ptr) ; 


結果は Pen 型の ポインタ bufPtr で 示される 構造体に 格納され る。 
返り 値は ない。 


$A14C  GMSetPen 


引 数 ► Ion 良  bufPtr  ; ペン 関係の 情報を 収めた バッファへの ポイ 

ンタ 

返り 値 なし 

機 能 ►  bufPtr で 指定した バッファの ペン 関係の 情報を、 々レント グラフ レコー ドに 
設定す る。 

C  の 関数 ►  void  GMSetPen  (Pen  *bufPtr) ; 

返り 値は ない。 


$A14D  GMI 打 itialize 
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引 数- なし 
返り 値 ►  なし 
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機 能 ►  グラフマンを 初期化す る。 フォントの アドレス など、 内部 ワークに セット される。 
C の 関数 ►  void  GMInitialize (void) ; 

返り 値は ない。 


$A14E 

GMNullRect 

引 数- 

long 

rectPtr 

; レク タン グル レコ ー 

ドへの ポイ ンタ 

返り 値 

D0.L 

=  0 

A0.L 

レク タン グル レコ 

ー ド への ポインタ が 返る 

機能 ► 

rectPtr で 指定した レク タング ル レコー ドを ヌル レク タング ルに する。 

疑似 ポイ ンタも 可。 

C の 関数 > 

void 

GMNullRect  (Rect 

幸 rectPtr) ; 

返り 値は ない。 

$A14F 

GMSizeRect 

引 数 

long 

rectPtr 

; レク タン グル レコ ー 

ドへの ポイ ンタ 

long 

sizePt 

; サイズを 示す ポ イン 

卜 

返り 値 ► 

DO.L 

結果 

0 

ヌル レク タン グルになった 

1 

正; 常 終了 

-1 

才ーハ •ー フロー 

A0.L  レク タング ルレ コー ドへの ポイ ンタ か* 返る 

機 能 ►  rectPtr で 指定した レク タング ル レコードを、 sizePt で 指定した サイズに 
変更す る。 

疑似 ポイ ンタも 可。 

C の 関数 ►  int  GMSizeRect (Rect  *rectPtr ,  LPoint  sizePt) ; 

返り 値は 結果を 意味す る 数値。 


$A150 

GMAndRects 

引 数 

word 

rectNum 

； レク タング ル レコー ドの 個数 

long 

resultPtr 

; 結果の 入る レ クタ ン グル レコー ドへの ポイ 

ンタ 

long 

rectlPtr 

; 1 番目の レ クタ ン グルレ コー ドへの ポイ ンタ 

long 

rect2Ptr  ;  2 を 目の レ クタ ン グル レコー ドへの ポイ ンタ 

: (rectNum  個 分 続く） 

返り 値 ■- 

DO.L 

結果 

グラフマン 


0 

ヌル レク タン グル 

1 

正が; 終了 

-1 

エラー 

機 能 ►  rectNum で 指を した 個数の レク タング ルの 重なって いる 部々 を resultPtr 
で 指定した レク タング ル レコー ドに 返す。 

すべての ポインタに ついて、 疑似 ポインタ も 可。 

C の 関数 ►  int  GMAndRects ( int  rectNum,  Rect  *resultPtr ,  Rect 
rectlPtr ,  Rect  *rect2Ptr,  ... ); 

rectlPtr の^ 降の 引数の 数と rectNum の 値は 等しくなければ ならない。 
返り 値は 結果を 意味す る 数値。 


$A151 

GMMoveRect 

引 数 

long 

rectPtr 

; レク タング ルレ コードへの ポインタ 

long 

pt 

； 移動 先の ポイント （絶対 位證） 

返り 値 ► 

DO.L 

結果 

0 

ヌル レク タン グル 

1 

正常終了 

-1 

才 ー ノく ー フロ ー 

AO.L  レク タング ルレ コー ドへの ポイ ンタ か* 返る 
機 能 ►  rectPtr で 指定した レク タング ルを、 pt で 指定した ポイントが ホー ム 位置 
になる ように 移動させる。 

疑似 ポイ ンタも 可。 

C の 関数 ►  int  GMMoveRect ( Re ct  *rectPtr ,  LPoint  pt) ; 

返り 値は 結果を 意味す る 数値。 


$A152 


GMSlideRect 


引 数- 


返り 値 


long 

long 

DO.L 


rectPtr 

pt 

結果 


レ クタ ン グルレ コー ドへの ポイ ンタ 
移動 先の ポイント （相対 位置） 


0 

ヌル レ クタ ン グル 

1 

正常終了 

-1 

才  ー ノス ー フロ ー 

A0.L  レク タング ル レコー ドへの ポイ ンタ か' 返る 

機 能 >  rectPtr で 指定した レク タング ルを、 pt で 示された 値 だけ 相対 移動させる。 
疑似 ポィ ンタも 可。 

C の 関数 ►  int  GA すぶ ideKe が （氏 ect  *rectPtr ,  LPoint  pt) ; 

返リ 値は 結果を 意味す る 数値。 
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$A153 


GMInsetRect 


引 数 ■ 


long 
Ion 良 


返り 値 ►  D0.L 


rectPtr 
of  sPt 

結果 


レク タング ル レコー ドへの ポイ ンタ 
レク タング ル 拡大/縮小 オフ セッ トを 示す ポ 
イン ト 


0 

ヌル レク タン グル 

1 

正常が 了 

-1 

才 ー バ ー フロ ー 

A0.L  レク タング ルレ コー ドへの ポイ ンタが 返る 

機 能 ►  rectPtr で 指を した レク タング ルを ofsPt で 指定した オフセット々、 縮小 
する。 つま リ、 左上と を 下の 座標から、 それぞれ ofsPt で 示される （x，y) の 
値を 引く。 したがって、 ofsPt の （x，y) として 負の 値を 指定す る ことで、 レク 
タ ン グルの お大を 巧う ことになる。 

疑似 ポインタ も 巧。 

C の 関数 ►  int  GMInsetRect (Rect  幸 rectPtr,  LPoint  pt) ; 

返り 値は 結果を 意味す る 数値。 


$A154 

GMAndRect 

引 数 ► 

long 

resultPtr 

; 結果の 入る レク タング ルレ コー ドへの ポイ 

ンタ 

long 

rectlPtr 

;1 番目の レク タング ル レコー 

ドへの ポインタ 

返り 値 ► 

Ion 良 

DO.L 

rect2Ptr 

結果 

;2 番目の レク タング ル レコー 

ドへの ポイ ンタ 

ヌル レク タン グル 
正常終了 


A0.L  結果の 入る レク タング ルレ コードへの ポイ ンタが 返る 

機 能 ►  rectlPtr と rect2Ptr で 指* 定 した 2 つの レク タング ルの 重なって いる 矩 
形 領域を、 resultPtr で 指定した レク タング ルレ コードに 返す。 

すべての ポイ ンタ について 疑似 ポイ ンタも 可。 

C の 関数 ►  int  GMAndRect (Rect  *resultPtr ,  Rect  *rectlPtr , 

Rect  *rect2Ptr) ; 

結果は Rect 型の ポインタ resultPtr で 示される レク タング ル レコー ドに 
格納され る。 

返り 値は 結果を 意味す る 数値。 
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$A155 

GMOrRect 

引 数 

long 

resultPtr 

long 

rectlPtr 

long 

rect2Ptr 

返り 値*^ 

DO.L 

結果 

; 結果の 入る レク タング ルレ コー ドへの ポイ 
ンタ 

;1 番目の レク タング ルレ コー ドへの ポイ ンタ 
;2 番目の レク タング ルレ コー ドへの ポインタ 


0 


ヌル レク タン グル 
正常終了 


AO.L  結果の 入る レク タング ル レコー ドへの ポイ ンタが 返る 
機 能 ►  rectlPtr と rect2Ptr で 指定した 2 つの レク タング ルが 収まる 最小の 矩 
形 領域を resultPtr で 指定した レク タング ル レコー ドに 返す。 

すべての ポイ ンタ について 疑似 ポインタ も 可。 

C の 関数 ►  int  GMOrRect (Rect  *resultPtr ,  Rect  *rectlPtr , 

Rect  れ ect2Ptr) ; 

結果は Rect 型の ポインタ resultPtr で 示される レク タング ル レコー ドに 
格納 される。 

返り 値は 結果を 意味す る 数値。 


$A156 

GMPtInRect 

引 数 

Ion 長 

rectPtr 

; レク タング ルレ コードへの ポインタ 

long 

pt 

; ポイント 

返り 値 ► 

DO.L 

結果 

0 


ポイ ント はレク タング ルの 外側 
ポイ ント はレク タング ルの 内側 


機 能- 


pt で 指を した ポイントが rectPtr で 指定した レ クタ ン グルの 内侧か 外側 か 
を 調べる。 

疑似 ポイ ンタも 可。 


C の 関数 ►  BOOLEAN  GMPtInRectiRect 

返り 値は 結果を 意味す る 数値。 

本 rectPtr, し Point  pt) ; 

$A157 

GMEqualRect 

引 数 ► long 

rectlPtr 

;1 番目の レク タン グル レコ ー 

ドへの ポイ ンタ 

long 

返り 値- DO.L 

rect2Ptr 

結果 

;2 番目の レク タン グル レコー 

ドへの ポイ ンタ 

2 つの レ クタ ン グルは 同 じで ない 
2 つの レ クタ ン グルは 同じ 
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機 能 ►  rectlPtr と rectSPtr で 指定した 2 つの レク タング ルが 同じ 婚形 領域を 
示して いるか どうかを 調べる。 

すべての ポイ ンタ じついて 疑似 ポインタ も 可。 

C の 関数 ►  BOOLEAN  GMEq ualRect ( Re c t  ♦rectlPtr,  Rect  *rect2Ptr) ; 

返り 値は 結果を 意味す る 数値。 


$A158  GMEmptyRect 


引 数 ►  long  rectPtr  ; レク タング ル レコー ドへの ポインタ 

返り 値 ►  D0.L  結果 

0 1 レク タング ルは ヌル レク タング ルでは ない 
1  レ クタ ン グルは ヌル レ クタ ン グル 

機 能 ►  rectPtr で 指定した レク タング ルが ヌル レク タング ルで あるか どうかを 調べ 
る。 

疑似 ポインタ も 可。 

C  の 関数 ►  BOOLEAN  GMEmptyRect  (Rect  *rectPtr) ; 

返り 値は 結果を 意味す る 数値。 


$A159 

GMAdjustRect 

引 数- 

long 

resultPtr 

; 結果の 入る レク タング ルレ コー ドへの ポイ 

ンタ 

long 

outer RectPtr 

; 外側 じなる レ クタ ン グルレ コー ドへの ポイ 

ンタ 

long 

innerRectPtr 

; 内側になる レク タング ルレ コードへの ポイ 

ンタ 

返り 値 ► 

DO.L 

結果 

0 

移動し なかった 

1 

移動した 

-1 

エラー 

A0.L  結果の 入る レク タング ル レコー ドへの ポイ ンタが 返る 
機 能 ►  innerRectPtr で 指定した レク タング ルを、 outer  RectPtr で 示される 矩 
お 領域の 内部に 収ま るよう に 移動 させ、 その 結果を resultPtr じ 返す。 
すべての ポイ ンタ について 疑似 ポイ ンタ も 可。 

C の 関数 ►  int  GMAdjustRect (Rect  *resultPtr ,  Rect  *outerRectPtr , 
Rect  *iimerRectPtr) ; 

結果は Rect 型の ポインタ resultPtr で 示される レク タング ルレ コードに 
格納され る。 

返り 値は 結果を 意味す る 数値。 
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$A15A 


GMNewRgn 


引 

数- 

なし 

返り 値 ► 

DO.L 

AO.L 

機 

能- 

新しい 

リ ザル トコ ー ド 

リージョン レコ ー ドへの ハン ドル 
.ジョン レコ ー ド 用の ブロ ックを 作成し、 
た リージ ョ ンは ヌル リージョン。 

再配置が 発生す る。 

C の 関数 ►  R%ion  GMNewRgn  (void) ; 

返り 値は リー ジョン レコ ー ドへの ハン ドル。 


、ン ドルを 返す。 作成され 


$A15B 


GMDisposeRgn 


引 数 ► long  rgnHdl 

返り 値 ►  DO.L  リザルト コード 

機能 ►  rgnHdl で 指定した リージョン レコードを 廃棄す る。 
C の 関数 ►  int  GMDisposeRgn ( Regi on  **rgnHdl) ; 

返り 値は リザ ル トコ ー ド。 


; 廃棄す るリー ジョン レコ ー ドへの ハン ドル 


$A15C 


GMOpenRgn 


引 数- なし 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  々レント グラフ レコード に対して 巧 われる 揃 画の、 リージョンへの 記録を 關始 
する （ただし、 「リージョン じ 記録され る」 と 記された 描画に 限る）。 

ドロー  レベルが一 1 される。 

再配置が 発生す る。 

C の 関数 ►  int  GMOpenRgn  (void) ; 

返り 値は リ ザル ト コード。 


$A15D 


GMCloseRgn 


引 数 long  rgnHdl  ; 記録され た 結果を 返す リージョン レコー ド 

への ハン ドル 

返り 値 ►  DO.L  リ ザル トコ ー ド 

AO.L  りー ジョン レコ ー ドへの ハン ドルが 返る 

機 能 >  々レント グラフ レコード じついて 斤 われて いた リージョンの 記 緑を 終了し、 記 
録の 内容を rgnHdl で 指定した リージョン レコードに 返す。 

ドロー  レベルが +1 される。 


グラフ 7 ン 
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再配置が 発生す る。 

C の 関数 ►  int  GMC/oseRg’ 打 （Il%ion  **rgnHdl) ; 
返り 値は リ ザル ト コード。 


$A15E  GMNullRgn 


引 数 ►  long  rgnHdl  ; りー ジョン レコードへの ハンドル 

返り 値 ►  D0.L  リザルト コード 

A0.L  リ ージョ ン レコー ドへの ハン ドルが 返る 

機 能 ►  rgnHdl で 指定した リージョンを ヌル リージョンに する。 

再配置が 発生す る。 

C の 関数 ►  int  GMN ullRgn (Region  幸* rgnHdl ) ; 

返り 値は リ ザル トコ ー ド。 


$A15F  GMRectRgn 


引 

数 

long 

rgnHdl 

; リ ー ジョン レコ ー ドへの ハンドル 

long 

rectPtr 

; レク タング ルレ コードへの ポインタ 

返り 値 ► 

DO.L 

リザルト コ ー ド 

AO.L 

リージョン レコー 

ドへの ハン ドルが 返る 

機 

能- 

rgnHdl で 指定した リ ージョ 

ン を、 rectPtr で 指定した レク タング ルの 形 

する。 

rectPtr は 疑似 ポイ ンタら 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMRectRgn  (Region  **rgnHdl,  Rect  幸 rectPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A160  GMCopyRgn 


引 

数 

long 

aestRgnHdl 

; コピ ー 先の リ ー ジョン レコ ー ド への ハン ドル 

long 

srcRgnHdl 

; コピー 元の リージョン レコードへの ハンドル 

返り 値 

DO.L 

リ ザル トコ ー ド 

AO.L 

コ ピー 化の リージ ョ 

ン レコ ー ドへ のノ 、ン ドル 

機 

能 ■- 

srcRgnHdl で 指を した リージ 

ョンの 内容を destRgnHdl で ホ旨定 される リー 

ジョ ン レコ ー ドに コピ ー する。 
srcRgnHdl は 疑似 ノ 、ン ドル も 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMCb 巧ぶ が i(R% ion  幸* destRgnHdl,  R%ion  **srcRgnHdl) ; 
返り 値は リ ザル トコ ー ド。 
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$A161 


GMMoveRgn 


； リージョン レコードへの ハンドル 

; 移動 先の ポイント （絶対位置） 
ドへの ハン ドルが 返る 

J ー ジョンの バウンド レク タング ルを pt で 指; 

座標まで 移動させる。 

疑似 ハン ドル も 可。 

C の 関数 ►  int  GMMoveRgn  (Region  **rgnHdl,  LPoint  pt) ; 

返り 値は リ ザル トコ ー ド。 


引 

数 ► 

long 

rgnHdl 

long 

pt 

返り 値- 

DO.L 

リザルト コ ー ド 

AO.L 

リージョン レコ- 

機 

能 

rgnHdl で 指定した リージ 

$A162 


GMSlideRgn 


引数 ► long 
long 

返り 値 ►  D0.L 
A0.L 


rgnHdl 

pt 


リー ジョン レコ ー ドへの ハン ドル 

移動 先の ポイント け 目 対 位置） 


リ ザル トコ ー ド 

リ _ ジョン レコ ー ド への ハンド ルが 返る 
機 能 ►  rgnHdl で 指定した リージョンの バウンド レク タング ルを pt で 示された 値 
だけ 相対 移動させる。 

疑似 ハン ドル も 可。 

C の 関数 ►  int  GMS パ dejRg’ 打 （R%ion  **rgiiHdl,  LPoint  pt) ; 

返り 値は リ ザル トコ ー ド。 


$A163 


GMInsetRgn 


引 数 ► long 
long 

返り 値 ►  D0.L 


rgnhal 
of  sPt 

結果 


リージョン レコ ー ドへの ハン ドル 

リージ ョ ン 拡大/縮 小オ フ セット を 示す ポイ 
ント 


0 

ヌルりー ジョン 

1 

正常終了 

-1 

エラー 

A0 .  L  リ ー ジョン レコ ー ド への ハンド ルが 返る 

機 能 ►  rgnHdl で 指定した リー ジョンを ofsPt で 指定した オフセット 分、 縮小す 
る。 ofsPt の （x,y) として 貸の 値を 指定す る ことで リージョンの お大を 巧う 
ことじなる。 

再 配廣が 発生す る。 

C の 関数 ►  int  GMInsetRgn ( Regi on  幸* rgnHdl,  LPoint  pt) ; 

返り 値は 結果を 意味す る 数値。 
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$A164  GMAndRgn 


引 数 


返り 値 ► 


機 能 > 


long  resultHdl  ; 結果の 入る りー ジョン レコー ドへの ハンドル 

long  r 阱 IHdl  ; 1 番目の リージョン レコー ドへの ハンドル 

Ion 居  rgn2Hdl  ;  2 番目の リージョン レコー ドへの ハンドル 

D0.L  リ ザル トコ ー ド 

A0 .  L  結果の 入る リ ー ジョン レコ ー ド への ハンド ルが 返る 

rgnlHdl と rgn2Hdl で 指定した 2 つの リー ジョンの 重なって いる 部分を、 

resultHdl で 指定 した リージョン レコード に 返す。 


rgnlHdl,  rgn2Hdl は 疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMAndRgn  (Region  **resultHdl,  R%ion  **rgnlHdl , 
Region  幸 本 rgn2Hdl) ; 

結果は、 Region 型の ハンドル resultHdl で 示される リージョン レコー ド 


じ 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A165  GMOrRgn 


引数 ►  ；Long 
long 
long 

返り 値 ►  DO.L 
AO.L 


resultHdl  ; 結果の 入る リー ジョン レコー ドへの ハンドル 

rgnlHdl  ; 1 番目の リ ー ジョン レコ ー ド への ハンドル 

rgn2Hdl  ;  2 番目の リー ジョン レコードへの ハンドル 

リ ザル トコ ー ド 

結果の 入る リー ジョン レコ ー ドへの ハン ドルが 返る 


機能 ►  rgnlHdl と rgn2Hdl で 指定した 2 つの リージョンを 合成した 因 形を result 
Hdl で 指定した リージョン レコードに 返す。 


rgnlHdl , rgn2Hdl は 疑似 ポインタ も 可。 

再 配 遺が 発生す る。 

C の 関数 ►  int  GMOrRgn  (Region  **resultHdl,  Region  **rgnlHdl,  Region 
*rgn2Hdl) ; 

結果は、 R%; 1011 型の ハンドル resultHdl で 示される リー ジョン レコード 
に 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A166  GMDif 壬 Rgn 


引 数 ► long 
long 
long 

返り 値 ►  DO.L 


resultHdl 

rgnlHdl 

rgn2Hdl 

リ ザル ト コード 


結果の 入る リージョン レコー ドへの ハン ドル 
1 番目の リ ー ジヨ ン レコ ー ド への ハンドル 
2 番目の リ ー ジョ ン レコ ー ド への ハンドル 


275 


グラフマン 


AO.L  結果の 入る リージ ョ ンレ コー ドへの ハン ドルが 返る 
機能 ►  rgnlHdl で 指定 した リー ジョンの 内側で、 rgn2Hdl で 指定 した リー ジョン 
の 外側と いう 図形を、 resultHdl で 指を した リー ジョン レコードに 返す。 
rgnlHdl,  rgn2Hdl は 疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMDiffRg7](R%ion  ♦*resultHdl , Region  **rgnlHdl,  Region 
*rgn2Hdl) ; 

結果は、 Region 型の ハンドル resultHdl で 示される リージョン レコード 
じ 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A167 


GMXorRgn 


引 

数 ► Ion 良 

resultHdl 

long 

rgnlHdl 

long 

rgn2Hdl 

返り 値 ►  D0.L 

リ ザル トコー 

AO.L 

結果の 入る リ 

機 

自長 ►  rgnlHdl 

と  rgii2Hdl 

結果の 入る リージョン レコ ー ドへの ハン ドル 
1— 番目の リージ ョ ンレ コー ドへの ハン ドル 
2 を 目の リージョン レコ ー ドへの ハン ドル 


resultHdl で 指定 した リー ジョン レコー ド に 返す。 
rgnlHdl,  rgn2Hdl は 疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMXorRgn  (Region  **resultHdl , Region  **rgnlHdl  ,Regio 打 
れ gn2Hdl) ; 

結果は、 Region 型の ハンドル resultHdl で 示される リージョン レコー ド 
じ 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A168 

GMPtInRgn 

引 数- 

long 

rgnHdl 

; リージョン レコー ドへの ハンドル 

long 

pt 

; ポイント 

返り 値 ► 

DO.L 

結果 

ポ イン トは リージ ョ ン の外侧 
ポイ ントは リージ ョ ンの [勺 仙 J 
エラ— 


機能 >  pt です 旨定 した ポイント カぶ、 rgnHdl で 指定 した リー ジョンの 内側 か 外側 かを 
調べる。 

C の 関数 ►  int  GMP け 1ぶ知3( Re 呂 ion  **rgnHdl,  LPoint  pt) ; 

返り 値は 結果を 意味す る 数値。 
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$A169 

GMRectInRgn 

引 数- 

long 

rgnHdl 

; ij_ ジョン レコードへの ハンドル 

long 

rectPtr 

; レク タング ル レコー ドへの ポインタ 

返り 値 ► 

DO.L 

結果 

0  リージョンと レク タング ルは 重ならない 
1 リージョンと レク タング ルは 重なって いる 
-1 エラー 


機能 ►  rgnHdl で 指定した リー ジョンと rectPtr で 指定した レク タング ルに 重な 
る 部分が あるか どうかを 調べる。 

疑似 ハンドル、 疑似 ポインタ も 可。 

C の 関数 ►  int  GAIRecfcln 托 g 打 （Il%ion  ** rgnHdl,  Rect  *rectPtr) ; 

返り 値は 結果を 意味す る 数値。 


$A16A 

GMEqualRgn 

引 数- 

long 

rgnlHdl 

;1 番目の リージョン レコ ー ドへの ハン ドル 

1011 居 

rgn2Hdl 

;2 番目の リ ージョ ンレ コー ドへの ハン ドル 

返り 値 

DO.L 

結果 

0 

2 つの りー ジョ ンは同 じでは ない 

1 

2 つの リージ ョ ンは 同じ 

-1 

エラー 

機能 ►  rgnlHdl と rgn2Hdl で 指定した 2 つの リー ジョンが 同じ 図形を 示して いる 
かどう かを 調べる。 

すべての リージョンに ついて、 疑似 ハンドル も 可。 

C の 関数 ►  int  GMEqualRgn (Region  **rgnlHdl,  Region  **rgn2Hdl) ; 

返り 値は 結果 を 意味す る 数値。 


$A16B  GMEmptvRgn 


引 数 ►  long  rgnHdl  ; リー ジョン レコー ドへの ハンドル 

返り 値 D0.L  結果 


0 

リージ ョ ンは ヌル リ ージョ ン ではない 

1 

リ ージョ ンはヌ ノレ リージョン 

-1 

エラー 

機能 ►  rgnHdl で 指を したりー ジョンが ヌ ルリー ジョンで あるか どうかを 調べる。 
疑似 ハン ドル 可。 

C の 関数 ►  int  GMEmptyRgn  (Region  **rgnHdl) ; 

返リ 値は 結果を 意味す る 数値。 
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$A16C  GMImgToRgn 


引 

数 ► 

long 

rgnHdl 

; リー ジョン レコードへの ハンドル 

long 

bitmapPtr 

; ビッ ト マップ レコ ー ド への ポインタ 

long 

rectPtr 

; レク タング ルレ コードへの ポインタ 

返り 値 ► 

DO.L 

リ ザル トコー ド 

AO.L 

リー ジョン レコ ー 

ドへの ハン ドル 

機 

能- 

bitmapPtr で 指定され たビッ ト マップの rectPtr で 指定され た 範囲 巧で、 

々ラー コードが 0 じ [外の 領域を ボ め、 rgnHdl で 指ました リージョン じ 収める。 
ビッ ト マップが テキス ト タイプの 場合は アクセス ページが 参照され る。 
再配置が 発を する。 

C の 関数 ►  int  GMImgToRgn  (Region  **rgnHdl,  Bitmap  *bitmapPtr ,  Rect 
幸 rectPtr) ; 

結果は、 Region 型の ハンドル rgnHdl で 示される リー ジョン レコード じ 格 
納 される。 

返り 値は リ ザル トコ ー ド。 


$A16D  GMInitBitmap 


引 数 ►  word 

scri'vpe  ; 

スクリーン タイプ 

0 

テキス ト タイプ 

1 

グラフィック タイプ 

long 

bitmapPtr  ; 

ビッ 

ト マップ レコ ー ドへの ポイ ンタ 

返り 値 ►  D0.L  リザルト コード 

A0.L  ビッ ト マップ レコー ドへの ポイ ンタが 返る 


機 能 ►  bitmapPtr で 指定した ビットマップを scrType で 示された スクリ ーン タイ 
プで 初期化す る。 

疑似 ポインタ も 可。 

C の 関数 ►  int  GMIni tBi tmap ( int  scrType ,  Bitmap  ♦bitmapPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A16 巨  GMMove 


引 数 long  pt  ; 移動 先の ポイント （絶対位置） 

返り 値 ►  なし 

機 能 ►  カレント グラフ レコー ドの ペンを pt で 指定した 口ー カル 座標に 移動させる。 
C の 関数 ►  int  GMMove ( LP 〇 i nt  pt) ; 

返り 値は 意味を 持たない。 
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GMMoveRel 


引 数 long  pt  ; 移動 先の ポイントけ が ホ 位置） 

返り 値 ►  なし 

機 能 ► カレント グラフ レコードの ペンを pt で 示した 値に 従って 相が 移動させる。 
C の 関数 ►  int  GMMoveRel (LPoint  pt) ; 

返り 値は 意味を 持たない。 


$A170  GMLine 


引数 ► long  pt  ; ラインの 終点を 示す ポイント （絶対位置） 

返り 値 ►  D0.L  リ ザル トコー ド 

機 能 ►  ペンの 現在 位置から pt で 示した ポイントまで、 ペン モードと ペン サイズに 
従って ラインを 引く。 この結果、 ペン 位置は 終点に 移る。 

スク リプト じ I 己 I 录 される。 

リージ ョ ンに 記録され る。 

C  の 関数 ►  iirt  GMLine  (LPoint  pt) ; 

返り 値は リ ザル トコ ー ド。 


$A171  GMLineRel 


引 数 ► long  pt  ; ラインの 終点を 示す ポイント け 目 対 位置） 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  ペンの 現在 位置から、 pt で 示した 相が 位置の ポイントまで、 ペン モードと ぺ 
ン サイズに 従って ラインを 引く。 この結果、 ペン 位置は 終点に 移る。 

スク リプト に 記録され る。 

リージ ョ ンじ 記録され る。 

C  の 関数 ►  int  GMLineRel  (LPoint  pt) ; 

返り 値は リ ザル トコ ー ド。 


$A172  GMFrameRect 


引 数 ►  long  rectPtr  ; レク タング ルレ コードへの ポインタ 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  rectPtr で 指を した レク タング ルの 枠を、 ペン モードと ペン サイズに 従って 
描く。 

スク リプト に 記録され る。 

リージ ョ ンに 記録され る。 

疑似 ポイ ンタも 可。 
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C の 関数 ►  int  GMFrameRect ( Re c t  *rectPtr) ; 
返り 値は リザ ル トコ ー ド。 


$A173  GMFillRect 


引 数 ►  long  rectPtr  ; レク タング ルレ コードへの ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  rectPtr で 指定した レク タング ルを、 ペン モードに 従って 塗りつ ぶす。 
スク リプト に 記録され る。 

疑似 ポイ ンタも 可。 

C の 関数 ►  int  GMFillRect (Rect  *rectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A174  GMFrameOval 


引 数 ►  long  rectPtr  ; レク タング ル レコー ドへの ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  rectPtr で 指定した レク タング ルに 内梭 する 情 円の 枠を、 ペン モードと ペン 
サイズに 従って 描く。 

スク リプト に 記録され る。 

リージ ョ ンに 記録され る。 

疑似 ポイ ンタも 可。 

C の 関数 ►  int  GMFrameOval  (Rect  *rectPtr) ; 

返り 値は リ ザル トコー ド。 


$A175  GMFillOval 


引 数 ►  long  rectPtr  ; レク タング ル レコー ドへの ポインタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  RectPtr で 指ました レク タング ルに 内接す る 情 円を、 ペン モードに 従って 塗 
り つぶす。 

スク リプト に 記録され る。 

疑似 ポイ ンタも 可。 

C の 関数 ►  int  GMFillOval ( Re ct  *rectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A176  GMFrameRRect 
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rectPtr 


; レク タング ルレ コードへの ポインタ 


グラフマン 

long  ovalPt  ; 惰 円の X 直径、 y 直径を 示す ポイント 

返り 値 D0.L  リザルト コード 

機能 ►  rectPtr で 指定され たレク タング ルに 内接し、 ovalPt じ 示した ような 惰円 
の 4 分の 1 円周を 四角に 持つ ような ラ ウン ドレ ク タング ルの 枠を、 ペン サイズ、 
ペン モード に 従って 描く。 

スク リプト じ 記録され る。 

リージ ョ ンに 記録され る。 

疑似 ポインタ も 可。 

C の 関数 ►  int  GMFrameRRect (Rect  れ ectPtr,  LPoint  ovalPt) ; 

返り 値は リザルト コード。 


$A177 

GMFillRRect 

引 数- 

返り 値*^ 

long  rectPtr 

long  ova 丄 Pt 

DO .  L  リ ザル トコー ド 

； レク タング ル レコー ドへの ポインタ 
； 惰 円の X 直径、 y 直径を 示す ポイント 

機能 ► 

rectPtr で 指定され たレク タング ルに 内接し、 ovalPt に 示した ような 惰円 
の 4 分の 1 円周を 四角に 持つ よう な ラウンド レク タング ルを、 ペン モー ドに おつ 
て 塗りつ ぶす。 

スク リプト に 記録され る。 

疑似 ポイ ンタも 可。 

C の 関数 > 

int  GMFillRRect  (Rect 

返り 値は リ ザル トコ ー ド。 

*rectPtr,  LPoint  ovalPt; ; 

$A178 

GMFrameArc 

引 数 ► long 

rectPtr 

; 円弧が 内接す るレク タング ルレ コー ドへの 
ポインタ 

word 

StartAngle 

； 關始 角度  1 

word 

endAngle 

； 終了 角® 

返り 値 ►  DO . L 

リ ザル トコ ー ド 

機 能 ►  rectPtr ,  startAngle,  endAngle で 指を された 円弧の 枠を 揣 画する。 
スク リプト に 記録され る。 

リージ ョ ンに 記録され る。 


C の 関数 ►  int  GMFrameArc ( Re c t  *rectPtr ,  int  startAngle ,  int 
endAngle) ; 

返り 値は リ ザル トコ ー ド。 
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$A179  GMFillArc 


引 

数*^ 

long 

rectPtr 

; 円弧が 内接す るレク タング ル レコー ドへの 
ポインタ 

word 

St art Angle 

； 開始 角度 

word 

endAngle 

; 終了 角度 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

概 

能- 

rectPtr ,  startAngle, 
スク リプト に 記録され る。 

endAngle で’ 指定され た 円弧の 内部を 塗りつ ぶす。 

リージ ョ 

ンに 記録され る。 

C の 関数 > 

int  GMFillArc  (Rect  *rectPtr  ,int  start  Angle,  int  endAngle) ; 

返り 値は リ ザル トコ ー ド。 


$A17A  GMFrameRgn 


引 数 ►  long  rgnHdl  ; リー ジョン レコー ドへの ハンドル 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  rgnHdl で 指定した リージョンの 枠を、 ペン サイズ、 ペン モー ドに 従って 描く。 
スク リプト に 記録され る。 

リージョン じ 記録され る。 

疑似 ハン ドル も 可。 

C の 関数 ►  int  GM 扔 amaRg •打 （R%ion  ** rgnHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A17B  GMFillRgn 


引 数 ►  long  rgnHdl  ; リージョン レコードへの ハンドル 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  rgnHdl で 指定した リー ジョンの 中を ペン モー ドに 従って 塗りつ ぶす。 
スク リプト じ 記録され る。 

疑似 ハン ドル も 可。 

C の 関数 ►  int  GA す FiJiRg •打 （R%i on  **rgnHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A17C  GMFramePoly 


引 数 ►  long  polyHdl  ; ポリゴン レコー ドへの ハンドル 

返り 値 ►  DO.L  リ ザル トコ ー ド 
機 能 >  polyHdl で 指ました ポリゴンの 枠を 描画す る。 
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スク リプト に 記録され る。 

リージ ョ ンじ 記録され る。 

C の 関数 ►  int  GMFramePoly ( P 〇 ly gon  **polyHdl) ; 
返り 値は リ ザル トコ ー ド。 


$A17D  GMFillPolv 


引 数 ►  long  polyHdl  ; ポリゴン レコー ドへの ハンドル 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 polyHdl で 指定した ポリゴンの 内部を 塗りつ ぶす。 

スク リプト に 記録され る。 

リージョンに 記録され る。 

C の 関数 ►  int  GMFillPoly (Poly gon  **polyHdl) ; 

返り 値は リザ ル トコ ー ド。 


$A17E  GMScroll 


引 

数 

long 

rectPtr 

; ス クロ  _ ル 範囲の レク タン グル レコードへ 
のポイ ンタ 

long 

of  sPt 

; ス クロ ー ル オフセットを 示す ポイント 

Ion 良 

updateRgnHdl 

； 巧 描画の 範閣が 返 るりー ジョン レコードへ 

の ハン ドル 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

再 描画の 範囲が 返る リ 

— ジョ ン レコ ー ド への ハンド ルが 返る 

機 

能- 

rectPtr 

で 指定した 矩形 範囲 内で、 ofsPt で 示される 値 だけ スクロールを 巧 

う。 ス クロール によって 空白と なっ た 部々 が update 氏 gnHdl で ホ 旨を した リー 
ジョン レコードに 返る。 また、 空白と なった 部分は バックグラウンド々 ラーで 
塗りつ ぶされ る。 
rectPtr は 疑似 ポイ ンタも 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMScroll ( Re c t  *rectPtr ,  LPoint  of sPt , 

Region  **iipdateIlgnHdl); 

ス クロー ルに よって 空白と なった 部々 が Region 型の ハンドル rgnHdl で 示 
される リージ ョ ン レコー ド に 格納 される。 

返り 値は リ ザル トコ ー ド。 


$A17F  GMCopy 


引 数 ►  long  srcBitmapPtr  ; コピー 元 ビットマップ レコー ドへの ポインタ 
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返り 値 
機 能 > 


long 

destBitmapPtr 

long 

srcRectPtr 

long 

destRectPtr 

word 

copyMode 

long 

maskRgnHdl 

DO.L 

リ ザル トコー ド 

コピー 化ビッ ト マップ レコー ドへの ポイ ンタ 
コ ピー元 レ クタ ン グルレ コー ドへの ポイ ンタ 
コ ピー 先レク タング ルレ コー ドへの ポイ ンタ 
コ ピー モード 

マスク 範圃の リ _ ジョン レコ ー ドへの ハン 
ドル 


srcBitmapPtr で 指を した ビッ トマ ッ プの srcRectPtr で 指* をし た 範囲を、 
destBitmapPtr の 过 estRectPtr の 中の、 皿 askRgnHdl で キ旨定 した リー 


ジョ ン範圈 巧に コピー する。 コ ピー 元と コピー 先で レク タング ルの サイズが 異 


なる 場合は、 お大 / 縮小を 斤う。 

copyMode は、 ペン モードと 同様な 意味を 持つ。 

maskRgnHdl として 0 を 指定す ると、 マスクは 行わない。 

コピー 先と コピー 元の ビッ ト マップが 同一の 場合、 重なり 判定を 斤う。 


コ ピー 先の ビッ ト マップが々 レント ビッ ト マップと 同一の 場合、 グラフ レ クタ 


ン グル、 ビジ ブル リージョン、 クリップ リージョンで クリッピングを 行い、 ス 


ク リプト にも 記録す る。 

すべての ポインタ、 ハンドルは、 疑似 ポインタ、 疑似 ハンドル も 可。 

C  の 関数 ►  int  GMCopy  (Bitmap  *  srcBitmapPtr,  Bitmap  *destBitmapPtr , 


Rect  *srcRectPtr,  Rect  *destRectPtr , 


int  copyMode ,  Region  幸 幸 皿 askRgnHdl) ; 
返り 値は リ ザル トコ ー ド。 


$A180  GMCopyMask 


引 数 ► long 

srcBitmapPtr 

long 

destBitmapPtr 

long 

皿 askBitmapPtr 

Ion 呂 

srcRectPtr 

long 

destRectPtr 

long 

destPt 

long 

皿 askRectPtr 

返り 値 ►  DO.L 

リ ザル トコ ー ド 

； コピー 元 ビットマップ レコードへの ポインタ 
; コ ピー 化ビッ ト マップ レコ ー ドへの ポイ ンタ 
； マスクの ビッ ト マップ レコー ドへの ポイ ンタ 
； コピー 元レク タング ルレ コードへの ポインタ 
； コピー 先レク タング ルレ コードへの ポインタ 
; コピー 化の レク タング ルの 左上の 頂点を 意 
味す る ポイント 

； マスクの レ クタ ン グルレ コー ドへの ポイ ンタ 


機 肖^  ►  srcBitmapPtr で 指定 した グラフ レコ ー ドの srcRectPtr で 指定し た 範囲 
を、 destBitmapPtr の destPt からの 矩形 領域に コピーす る。 拡大/縮小 
は 斤わない。 コピー モー ドは pset に 固定。 

皿 askBit 皿 apPtr は、 テキスト タイフ。 で 1 ぺー ジ。 皿 askRectPtr 巧の ビッ 


ト イ メージ もビッ トが 1 の 部々 について コピーが 斤 われる。 


コ ピー 先の ビッ ト マップが々 レント ビッ ト マップと 同一の 場合、 グラフ レ クタ 
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ン グル、 ビジ ブル リージョン、 クリップ リージョンで クリッピングを 巧う。 
すべての ポインタは、 疑似 ポインタ も 可。 

C の 関数 ►  int  GMCopyMask (Bitmap  *srcBitmapPtr , 

Bit 皿 ao 幸 destBit 曲 apPtr ,  Bitmap  幸 皿 askBit 虹 apPtr , 

Rect  *srcRectPtr,  LPoint  destPt ,  Rect  *inaskRectPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A182  GMPlotlmg 


引数 I 


long 

long 


plotlmgPtr 

rectPtr 


word  plotMode 


返り 値 ►  DO . L 


リ ザル トコ ー ド 


; プロット イメージへの ポイ •ンタ 
; 描画 範囲の レク タング ルレ コードへの ポイ 
ンタ 

; プロ ッ トモ ー ド 


上位 8 ビット 

ページ 数 （0 〜 4) 

0 を 指定す ると、 2 を 指を 

した ことと 同じになる 

下位 8 ビット 

0 

標準 

1 

反転 

2 

ハイ ライト 

3 

ハイ ライ ト 反転 

4 

消 ま 

6 

網 掛け 

7 

網 掛け 反 串 云 

8 

不可視 

9 

不可視 反転 

機 能 ►  plotlmgPtr で 指定した プロット イメージを、 カレント グラフ レコー ドの rect 
Ptr で 指定した 領域に 揃 画する。 描画 領域は 128x128 ドッ トじ 1内。 
plotlmgPtr は、 疑似 ポインタ も 可。 

C の 関数 ►  int  GMPio tJmgCuns igned  short  *plotImgPtr ,  Rect  れ ectPtr, 
int  plotMode) ; 

返り 値は リ ザル トコ ー ド。 


$A183  GMPutRImg 


引 数 ►  Ion 良  rectlmgPtr  ; レク タング ルイ メージ への ポインタ 

long  pt  ; 描 晒す る ポイント 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  rectlmgPtr で 指定した レク タング ルイ メージ を、 カレント グラフ レコード 
の pt の 座標から 描画す る。 描圃モ ー ドは pset。 
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テキス ト タイプの グラフ レコードの 場合、 描画す る ぺージ は グラフ レコード 内 
の 設定に 依存す る。 

疑似 ポインタ も 可。 

C の 関数 ►  int  GMPu tRImg ( Re c t Img  *rectImgPtr ,  LPoint  pt) ; 

返り 値は リ ザル トコ ー ド。 


$A186 

GMDupHImg 

引 数 

long 

imgPtr 

; テキスト タイプの ビット イ メージ への ポイ 

ンタ 

long 

pt 

； 描画す る ポイント 

word 

height 

; ビット イメージの y 方向の サイズ 

word 

width 

； 描画す る X 方向の ドット 数 

返り 値*^ 

DO.L 

リ ザル トコ ー ド 

機能 >  imgPtr で 指定した テキスト タイプの ビット イメージ （X 方向 サイズは 1 ドッ 
卜） を、 々レント グラフ ポートの pt の 座標から X 方向に width ドット 繰り 
返して 揃 画する。 

疑似 ポインタ も 可。 

C の 関数 ►  int  GMD u pHImg (unsigned  short  *imgPtr ,  LPoint  pt, 
int  height ,  int  width) ; 

返り 値は リ ザル トコ ー ド。 


$A187 

GMDupVImg 

引 数- 

long 

imgPtr 

; テキスト タイプの ビット イメージへの ポイ 

ンタ 

long 

pt 

； 描画す る ポイント 

word 

width 

. ビット イメージの X 方向の サイズ 

word 

height 

; 揣 画する y 方向の ドット 数 

返り 値 

DO.L 

リ ザル トコ ー ド 

機 能 ►  imgPtr で 指定した テキスト タイプの ビット イ メージ （y 方向 サイズは 1 ドッ 
卜） を、 々レント グラフ ポートの pt の座概 から y 方向に height ドッ ト繰 
り 返して 揣 画する。 

疑似 ポイ ンタも 可。 

C  の 関数 ►  int  GMD  up  VImg  (unsigned  short  *i  皿  gPtr,  LPoint  pt, 
int  width,  int  height) ; 

返り 値は リ ザル トコ ー ド。 


286 


グラフマン 


$A188 

GMDupHRImg 

引 数*^ 

long 

rectlmgPtr 

; レク タング ルイ メージ への ポインタ 

long 

pt 

； 描画す る ポイント 

word 

width 

； 描画す る X 方向の ドット 数 

返り 値 ► 

DO.L 

リザ ノレ トコ ー ド 

機能 > 

rectlmgPtr で 指を した テキス ト タイプの レク タング ルイ メージ （x 方が I サイ 

ズは 16 

ドッ トじ 1 下） を、 カレント グラフ レコー ドの pt の 座標から X 方向に 

width 

ドッ ト 繰り返して 描画す る。 

疑似 ポインタ も 可。 

C の 関数 ►  int  GMD upHRImg ( Re c t Img  *rectImgPtr ,  LPoint  pt, 

int  width) ; 

返り 値は り ザル トコ ー ド。 

$A189 

GMDupVRImg 

引 数*" 

long 

rectlmgPtr 

; レク タング ル イメージへの ポインタ 

long 

pt 

； 描画す る ポイント 

word 

height 

; 描画す る y 方向の ドット 数 

返り 値 

DO.L 

リ ザル トコ ー ド 

機 能 ► 

rectlmgPtr で 指定した テキス ト タイプの レク タング ルイ メージ （y 方向 サイ 

ズは 16 

ドッ トじ [下） を、 々レント グラフ レコードの pt の 座標から y 方向に 

height ドッ ト 繰り返して 描画す る。 

疑似 ポイ ンタも 可。 

C の 関数 ► 

int  GAfD up VRimg( Re ct Img  *rectImgPtr ,  LPoint  pt, 

int  height) ; 

返り 値は リ ザル トコ ー ド。 

$A18B 

GMFontKind 

引 数- 

word 

f ontKind 

; フォント カ インド 

0 

ROM 12 フォント 

1 

ROM16 フォント 

2 

ROM24 フォント 

3 〜 

フォン ト マンに 登録され ている 

フォント 

返り 値 ►  DO.W  前の フォント カ インド 

機 能 ►  カレント グラフ レコー ドの フォント々 インドを font  Kind にす る。 
スク リプト じ 記録す る。 

再配置が 発を する。 
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C の 関数 ►  int  GMFontKind ( int  f  ontKind) ; 
返り 値は 前の フォント カ インド。 


$A18C  GMFontFace 


引 数 ►  word  f ontFace  ; フォント フェイス 


bitO 

ボ ー ルド 

bitl 

イタリック 

bit2 

アンダーライン 

bits 

中 巧き 

bit4 

影 付き 

返り 値 ►  D0.W  前の フォント フュ イス 

機 能*"  々レント グラフ レコードの フォント フェイスを f  ontFace にす る。 
スク リプト に 記録す る。 

再配置が 発生す る。 

C の 関数 ►  int  GMFontFace ( int  f  ontFace) ; 

返り 値は 前の フォン トフ ュ イス。 


$A18D  GMFontMode 


引 数 ►  word  f ontMode  ; フォント モード 


0 

pset 

1 

and 

2 

or 

3 

xor 

4 

npset 

5 

nand 

6 

nor 

7 

nxor 

+ $10 で 文字の 背景を 揃 画しない 

返り 値 ►  D0.L  前の フォン トモード 

機 能 ►  々レント グラフ レコードの フォント モードを f  ontMode にす る。 
スク リプト に 記録す る。 

再 配 農が 発生す る。 

C  の 関数 ►  int  GMF ontMode  (int  f  ontMode) ; 

返り 値は 前の フォ ン トモー ド。 


$A18E  GMFontSize 


引 数 ► long  sizePt  ; フォント サイズを 示す ポイント 

返り 値 ►  D0.L  前の フォント サイズを 示す ポイント 
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機 能 ►  々レント グラフ レコー ドの フォント サイズを sizePt の （x,y) に 設定す る 
(128x128 ドッ ト Ja 内）。 （0,0) を 指定す ると、 それぞれの フォント カ インドの 標 
準の サイ ズ になる。 

スク リプト に 記録す る。 

再 配 霞が 発生す る。 

C の 関数 ►  LPoint  GMFontSize ( LPo int  sizePt) ; 

返り 値は 前の フォン ト サイズを 意味す る ポイント。 


$A18F  GMDrawChar 


引 数 ►  word  ch  ; 描画す る キャラクタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  カレント グラフ レコードの ペン 位 蘆から ch で 指定され た キャラクタを、 フォ 
ント 々インド、 フォント フェイス、 フォン トモー ド、 フォント サイズ、 フォ アグ 
ラウンド々 ラー、 バックグラウンド カラーに 従って 描画す る。 

スク リプト じ 記録す る。 

再配置が 発生す る。 

C の 関数 ►  int  GMDrawChardnt  ch) ; 

返り 値は リ ザル トコ ー ド。 


$A190  GMDrawStrL 


引 数 ►  long  strLPtr  ;  LASCII 型の 文字列への ポインタ 

返り 値 ►  D0.L  リザ ル トコード 

機 能 ►  カレント グラフ レコー ドの ペン 位置から、 StrLPtr で 指を された LASCII 迴 
の义字 列を、 フォント カ インド、 フォント フェイス、 フォン トモー ド、 フォント 
サイズ、 フォアグラウンド々 ラー、 ハ* ック グラウンド 々ラーに 従って 揃 画する。 
スク リプト じ 記録す る。 

疑似 ポインタ も 可。 

再配置が 発生す る。 

C  の 関数 ►  int  GMDrawStrL  ( const  —LASCII  *  strLPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A191  GMDrawStr 


引 数- 

long 

strPtr 

; 文字列への ポイ ンタ 

long 

offset 

; 文字列 先端からの オフ セッ 

word 

length 

； 文字列の バイト 数 

返り 値 

DO.L 

リザ ル トコ ー ド 
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機 能 ►  strPtr で 指定した 义ぞ 列の、 offset バイ ト 目から length バイ トの义 字 
列を 表示す る。 

描 晒は、 々レント グラフ レコードの ペン 位置から、 フォント々 インド、 フォン 
ト フェイス、 フォント モード、 フォント サイズ、 フォアグラウンド々 ラー、 ハ* ッ 
ク グラウン ド カラーに 従って 行われる。 

スク リプト に 記録す る。 

疑似 ポイ ンタも 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMDrawStr (const  char  *strPtr,  long  offset , 
int  length) ; 

返り 値は り ザル トコ ー ド。 


$A192  GMDrawStrZ 


引 数 ► long  strZPtr  ;  ASCIIZ 型の 义字 列への ポインタ 

返り 値 ►  D0.L  リザルト コード 

機能 ►  カレント グラフ レコードの ペン 位置から、 StrZPtr で 指定され た ASCIIZ 型 
の 文字列を、 フォント々 インド、 フォント フユ イス、 フォント モード、 フォント 
サイズ、 フォアグラウンド々 ラー、 バックグラウンド カラーに 従って 描画す る。 
スク リプト に 記録す る。 

疑似 ポインタ も 可。 

再配置が 発生す る。 

C  の 関数 ►  int  GMDrawStrZ  (const  char  *strZPtr) ; 

返り 値は リ ザル トコー ド。 


$A194  GMCharWidth 


引 数 ►  word  ch  ; キャラクタ 

返り 値 D0.L  結果/リザルト コード 


上位 ワード 

イタリック width 

下位 ワード 

width 

機 能 ►  ch で 指定した キャラクタの 横幅を、 々レント グラフ レコー ド 巧の フォント 関 
係の メ ンバじ 従って 求める。 

再配置が 発生す る。 

C の 関数 ► long  GMCharWidth ( int  ch) ; 

返り 値は、 上位 ワー ドが イタ リ ッ クで揣 画した 場合の 横幅、 下位 ワー ドが 通常 
の 横幅。 エ ラーが 発生した 場合は リ ザル トコ ー ド。 
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$A195  GMStrLWidth 


引 数 ► long  strLPtr  ;  LASCII 型の 文字列への ポインタ 

返り 値 ►  D0.L  結果/リザルト コード 


上位 ワード 

イタリック width 

下位 ワード 

width 

機 能 ►  strLP む： で 指定した 文字列の 横幅を、 カレント グラフ レコード 内の フォント 
関係の メ ンバじ 従って ボ める。 

疑似 ポインタ も 可。 

再配置が 発生す る。 

C  の 関数 ► long  GMStrLWidth  ( const  —LASCII  *  strLPtr ) ; 

返り 値は、 上位 ワードが イタり ックで 描画した 場合の 横幅、 下位 ワードが 通常 
の 横幅。 エラーが 発生した 場合は リザルト コード。 


$A196 

GMStrWidth 

引 数- 

long 

StrPtr 

； 文字列への ポインタ 

long 

offset 

； 文字列 先端からの オフセット 

word 

length 

; 文字列の バイト 数 

返り 値 ► 

DO.L 

結果/ リ ザル トコ ー ド 

上位 ワード 

イタリック width 

下位 ワード 

width 

機 能 ►  strPtr で 指定した 义字 列の、 offset バイ ト 目から length バイ トの义 字 
列の 横幅を、 々レン ト グラフ レコ ー ド 巧の フォン ト 関係の メ ンバに 従って ポめ 
る。 

疑似 ポイ ンタも 可。 

再配置が 発生す る。 

C の 関数 ► Ion 長  GMStrWidth ( const  char  *strPtr,  long  offset , 
int  length) ; 

返り 値は、 上位 ワードが イ タリ ックで 描画した 場合の 横幅、 下位 ワードが 通常 
の 横幅。 エラーが 発生した 場合は リザルト コード。 


$A197  GMStrLength 


引 

数 

long 

StrPtr 

; 文字列への ポイ ンタ 

long 

0 む  set 

; 文字列 先端からの オフセット 

word 

width 

; K . ソト榮 C 

返り 値 ► 

DO.L 

文字列の バイト 数 

機 

能- 

々レント グラフ レコード 内の フォント 閱 係の メンバに 従った 場合、 StrPtr の 

示す 文字列の offset  ノ 、•イ ト 目から 何 バイ トを width ドッ ト のなかで 表示 
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できる かを ボ める。 文字列の なかに コントロール コードが あった 場合、 その 前 
の 文字までの バイ ト 数を 返す。 

疑似 ポイ ンタも 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMStrLength (const  char  *strPtr , long  offset , 
int  length) ; 

返り 値は 文字列の バイ ト 数。 


$A198  GMFontInfo 


引 数 なし 

返り 値 ►  D0.L  結果 


上位 ワード 

width 

下位 ワード 

height 

機 能 ► 1 文字のを 角 文字の 幅と 高さの 最大値を、々 レント グラフ レコード 内の 情報に 
従って 求める。 イタリック wid 化は 返らない。 

再配置が 発生す る。 

C の 関数 ►  LPoint  GMFontInfo  (void) ; 

返り 値は 横幅と 高さを 意味す る ポイント。 


$A199  GMOpenScriDt 


引 数 ►  long  rgnHdl  ; りー ジョン レコー ドへの ハンドル 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  々レント グラフ レコード に対して 行われる 描画の スク リプト への 記録を 開始す 
る （ただし、 「スクリプトに 記録され る」 と 記された 揣 画に 限る）。 rgnHdl で 
指定した リ ージョ ン がスク リプト の 外形と なり、 この リー ジョ ンの バウンド レ 
ク タング ルが スク リプト の 大きさと なる。 

ドロー レベルが -1 される。 

疑似 ハン ドル も 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMOpenScript (Region  ** rgnHdl) ; 

返リ 値は リ ザル トコ ー ド。 


$A19A  GMCloseScript 


引 数 ► long 

scriptHdl 

； 記録され た 結果を 返す スク リプ トレ コード 

への ハン ドル 

返り 値 ►  DO.L 

リ ザル トコ ー ド 
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AO.L  スクリプト レコ ー ドへの ハン ドルが 返る 
機能 ►  カレント グラフ レコード について 斤 われて いた スクリプトの 記録を 終了し、 記録 
の 内容を scriptHdl で 指定した スクリプト レコー ドに 返す。 scriptHdl 
として 0 を 指定した 場合、 グラフマンが ブロックを 確保し、 ハンドルを 返す。 
ドロー  レベルが +1 される。 

再配置が 発生す る。 

C の 関数 ►  int  GAf CJoseScri が （GScript  **scriptHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A19B  GMDisposeScript 


引 数 ► long  scriptHdl  ; スクリプト レコー ドへの ハンドル 

返り 値 ■-  D0.L  リザルト コード 

機 能 ►  scriptHdl で 指定した スクリプト レコードを 廃棄す る。 

C の 関数 ►  int  GMDisposeScrip t(GScript  **scriptHdl) ; 

返り 値は り ザル トコ ー ド。 


$A19C  GMDrawScript 


引 

数- 

long 

scriptHdl 

; スクリプト レコ ー ドへの ハン ドル 

long 

rectPtr 

; レク タング ル レコー ドへの ポインタ 

返り 値 

DO.L 

リ ザル トコ ー ド 

機 

能 

scriDtHdl で 指定した スクリプトを、 々レント グラフ レコードに 描画す る。 ス 

ク リプト の 外形を 示す りージョンの バ ウン ドレ ク タング ルの 大きさが rectPtr 
で、 指定した レク タング ルと 等しくな るよう、 お大 / 縮小を 斤う。 
rectPtr は 疑似 ポイ ンタも 可。 

再配置が 発生す る。 

C の 関数 ►  int  GMDrawScript ( GS cr ipt  **scriptHdl,  Rect  *rectPtr) ; 

返り 値は リ ザル トコー ド。 


$A19D  GMGetScript 


引 数 

long 

long 

返り 値 ► 

DO.L 

AO.L 

scriptHdl  ; スクリプト レコー ドへの ハンドル 

offset  ; オフ セッ ト 位置 

かの コマン ドへの オフセット 
-1 : エラー 
次の コマン ドへの ポイ ンタ 


機 能 ►  scriptHdl で 指定した スクリプト レコード 内部の スクリプト データの、 先頭 
から offset バイ ト 目から、 みの コマンドの 位置を 返す。 offset として 0 
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を 指定した 場合、 最初の コマンドを 返す。 

C の 関数 ► long  GMGetScript (GScript  ♦♦scriptHdl , int  offset) ; 
返り 値は 次の コマン ドへの オフセット。 


$A19E  GMOpenPoly 


引数- なし 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  ポリゴンの 記録を 關始 する。 ドロー レベルが 一1 され、 じ I 降、 実行され る $A170 
GMLine で 描画し た 座標が 記録 される。 

再配置が 発生す る。 

C の 関数 ►  int  GMOpenPoly (^v old) ; 

返り 値は リ ザル トコ ー ド。 


$A19F  GMClosePoly 


引 数 ► 1011 良  polyHdl  ; ポリゴン レコードへの ハンドル 

返り 値 ►  DO.L  リザルト コード 

A0 .  L  ポリゴン レコ ー ド への ハンドル 

機 能 ►  ポリゴンの 記録を 終了し、 polyHdl で 指定した ポリゴン レコード じ 結果を 返 
す。 polyHdl として 0 を 指定す ると、 グラフマンが ヒープ 上に 再配置 可能 ブ 
ロックを 作成し、 そこに 結果を 収めて ハンドルを 返す。 

再配置が 発生す る。 

C の 関数 ►  int  GMC7ose_Po か (Polygon  **polyHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A1A0  GMDisDOsePoly 


引 数 ► 1011 呂  polyHdl  ; ポリゴン レコードへの ハンドル 

返り 値 ►  D0.L  リザ ル トコー ド 

機能 ►  polyHdl で 指定した ポリゴン レコー ドを 廃棄す る。 

C の 関数 ►  int  GMDisposePoly (Polygon  **polyHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A1A1  GMShadowStrZ 


引 数 ►  long  strZPtr  ;  ASCIIZ 型の 文字列への ポインタ 

long  pt  ; 描画す る ポイント 

返り 値*-  D0.L  リザルト コード 
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機能 ► 々レント グラフ レコードの pt で 指定され た ポイントから、 strZPtr で 指を し 
た ASCIIZ 型の 文字列を 影 付きで 表示す る。 背景は バックグラウンド々 ラー、 
文字は 黒、 景夕は 白に 固定。 この結果、 ペン 位置は 最後の 文字の 次の 位置に 移動 
する。 

疑似 ポインタ も 可。 

C の 関数 ►  int  GMShadowStrZiconst  char  *strZPtr ,  LPoint  pt) ; 

返り 値は リザルト コード。 


$A1A2  GMShadowRect 


引 数 ►  long  rectPtr  ; レク タング ルレ コードへの ポインタ 

返り 値 ►  D0.L  リ ザル トコー ド 

機 能 ►  カレント グラフ レコー ドに rectPtr で 指定され るレク タング ルの 枠を、 景夕付 
きで 描画す る。 上辺と 左辺は 黒、 右辺と 下 辺は 薄 灰色に 影が 白く 描画され、 内 
部は バック グラウン ド々 ラーで 塗りつ ぶされ る。 

疑似 ポインタ も 可。 

C の 関数 ►  int  GMShadowRect (Rect  れ ectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A1A3  GMInvertRect 

引 数 ► Ion 良  rectPtr  ; レク タング ル レコー ドへの ポインタ 

word  lineStyle  ; ライン スタイル 

返り 値 D0.L  リザルト コード 

機 能 ►  々レント グラフ レコードに rectPtr で 指定され るレク タング ルの 枠を、 line 
Style で 示された ライン スタイルで、 描画 モード X0 民 で 描画す る。 クリッ 
ピン グは ビッ ト マップ レク タング ルとの み 行われる。 

疑似 ポイ ンタも 可。 

C の 関数 ►  int  GMInvertRect  (Re ct  *rectPtr ,  int  lineStyle) ; 

返り 値は リ ザル トコ ー ド。 


$A1A5  GMInvertBits 


引 

数*^ 

long 

pt 

; 描画す る ポイント 

long 

bitmapPtr 

; ビッ ト マップへの ポイ ンタ 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

が 

能- 

カレン 

ト グラフ レコードの pt 

で 指定した 位置に、 bitmapPtr で 指定され た 

ビット イメ ージを 描画 モード XO 民 で 描画す る。 クリッピングは ビットマップ 
レク タング ルとの み 斤 われる。 


ク ラフ 7 ン 


295 


グラフマン 


疑似 ポインタ も 可。 

C の 関数 ►  int  GMInvertBi ts ( LPo int  pt.  Bitmap  *bitmapPtr) ; 
返り 値は リザ ル トコ ー ド。 


$A1A6 

GMMapPt 

引 数 

long 

pt 

; オリ ジナルの ポイント 

long 

srcRectPtr 

; pt を 含む レク タング ルレ 
ンタ 

コ ー ド への ポイ 

long 

destRectPtr 

; 写像 先の レク タン グル レコ- 

- ドへの ポインタ 

返り 値 ► 

DO.L 

結果を 示す ポ イン I 

機 能 >  srcRectPtr で 示される レク タング ルと ポイント pt の 位置 関係に 相当す る、 
destRectPtr 中の ポイント を 返す。 srcRectPtr,  destRectPtr のど ちら 
か 一方で も ヌル レク タング ルであった 場合、 結果は （0,0) となる。 

すべての ポインタは、 疑似 ポインタ も 可。 

C の 関数 ►  LPoint  GMMapPt (LPoint  pt ,  Rect  *srcRectPtr , 

Rect  幸 destRectPtr) ; 

返り 値は 結果を 示す ポイント。 


$A1A7  GMMapRect 


引 

数 ► 

long 

rectPtr 

; オリ ジナルの レク タン グル 

Ion 良 

srcRectPtr 

; rectPtr を 含む レ クタ ン グル レコー ドへの 
ポインタ 

long 

destRectPtr 

; 写像 先の レク タング ルレ コー ドへの ポイ ンタ 

返り 値 ► 

DO.L 

0 

AO.L 

rectPtr 

機 

能- 

srcRectPtr で 示される レク タング ルと レク タング ル rectPtr の 位置 関係 じ 

相当す る、 destRectP れ 中の レク タング ルを 返す。 結果は、 引数と して 渡した 
rectPtr で ネ旨定 された レコード のなかに 返る。 srcRectPtr ,  destRectPtr 
のど ちら か 一方で も ヌル レク タン グルで あっ た 場合、 結果は ヌル レク タン グル 
となる。 

すべての ポインタは、 疑似 ポインタ も 可。 

C の 関数 ►  void  GMMapRect  (Rect  *rectPtr ,  Rect  *srcRectPtr , 

Rect  *destRectPtr) ; 

結果は Rect 型の ポインタ rectPtr で 示される レク タング ル レコー ドに 格 
納 される。 

返り 値は ない。 
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$A1A8  GMMapPoly 


引 

数*^ 

long 

polyHdl 

; ポリ ゴン レコ ー ドへの ハン ドル 

long 

srcRectPtr 

; 写像 元の レ クタ ン グルへの ポイ ンタ 

long 

destRectPtr 

; 亭像 先の レ クタ ン グルへの ポイ ンタ 

返り 値 

DO.L 

0 

AO.L 

ポリ ゴン レコ ー 

ドへの ハン ドル 

機 

能 

srcRectPtr で 指定され たレク タング ル 上に ある polyHdl で 指定した ポリ 

ゴン を、 destRectPtr 上に 写像した 結果を polyHdl 内に 返す。 どちら か 
のレク タング ルが ヌル レク タン グルの 場合、 結果は ヌ ルポ リゴンと なる。 
再配置が 発生す る。 

C  の 関数 ►  void  GMMapPoly  (Polygon  **polyHdl , Rect  *srcRectPtr ,  Rect 
destRectPtr) ; 

結果は、 Polygon 型の ハンドル polyHdl で 示される ポリゴン レコード じ 格 
納 される。 

返り 値は ない。 


$A1A9 

GMMapRgn 

引 数- 

long 

rgnHdl 

; オリ ジナルの リージョン 

Ion 良 

srcRectPtr 

; rectPtr を 含む レク タング ル レコー ドへ 

のポイ ンタ 

long 

destRectPtr 

; 写像 先の レク タング ルレ コー ドへの ポインタ 

返り 値 

DO.L 

0 

AO.L 

rgnHdl 

機 能 ►  srcRectPtr で 示した レク タング ル 中の rgnHdl じ 相当す る、 destRectPtr 
で 示される レク タング ル 中での リージョンを 返す。 結果は、 引数と して 渡した 
rgnHdl で 指定され た レコー ドの なか じ 返る。 srcRectPtr ,  destRectPtr 
のど ちら か 一方で も ヌル レク タン グルで あっ た 場合、 結果は ヌル レク タン グル 
となる。 

すべての ポイ ンタは 疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ►  void  GMMapRgn (Region  **rgnHdl,  Rect  *srcRectPtr , 

Rect  *destRectPtr) ; 

結果は、 Region 型の ハンドル rgnHdl で 示された リー ジョン レコー ドに 格 
納 される。 

返り 値は ない。 
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$A1AA 

GMScalePt 

引 数- 

long 

pt 

long 

srcRectPtr 

long 

destRectPtr 

返り 値 ► 

DO.L 

変換 後の ポイント 

オリ ジナルの ポイント 

元の レ クタ ン グル レコー ドへの ポイ ンタ 

変換 後の レク タング ルレ コー ドへの ポイ ンタ 


機 能 ►  srcRectPtr で 示される レク タング ルが、 destRectPtr で 示される 大きさ 
までが: 大 / 縮小され た 場合、 srcRectPtr 中に ある pt で 指を された ポイント 
が 移動す る 位置を 返す。 srcRectPtr,  destRectPtr のど ちらか 一方 ■でも ヌ 
ルレ ク タング ルであった 場合、 結果は （0,0) となる。 

すべての ポインタは、 疑似 ポインタ も 可。 

C の 関数 ►  LPoint  GMScalePt ( LPo int  pt,  Rect  *srcRectPtr , 

Rect  *destRectPtr) ; 

返り 値は 変換 後の ポイント。 


$A1AB 


GMInitPalet 


引数- なし 
返り 値 ►  なし 

機能 ►  SRAM に 収められ ている テキス ト パレット データを テキス ト パレ ッ トに設 を 
する。 

C の 関数 ►  void  GMInitPalet  (void) ; 

返り 値は ない。 


$A1AD 


GMDrawGie 


引 数- 


glGImgPtr 

pt 


; G16 イメージ レコードへの ポインタ 

； 描画す る ポイント 


Ion 良 
long 

返り 値 >  なし 

機能 ►  グラフィック タイプの々 レント グラフ レコ 
で 指定され た G16 イメージを 揣 画する。 

疑似 ポイ ンタも 可。 

C の 関数 ►  void  GMDrawG 1 6 ( TX 1 6  *gl6ImgPtr ,  LPoint  pt) ; 
返り 値は ない。 


ドの pt の 位置から、 gieimgPtr 


$A1AF 


GMGetPixel 


引 数 ► long  bitmapPtr 

long  pt 


; ビッ トマ ッフ 。レコー ド への ポインタ 
； 色を 読み出す ポイント 
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返り 値 ►  DO.W  パレット コード 

機 能 ►  bitmapPtr で 指定され た ビットマップ のなかの pt の 位置の パレ ッ トコード 
を 返す。 pt が ビットマップ レク タング ルの 外なら 0 が 返る。 テキスト タイプ 
のビッ ト マップの 場合、 ビッ ト マップ レコード 内の アクセス ぺージ が 参照され 
る。 

疑似 ポイ ンタも 可。 

C の 関数 ►  int  GMGetPixel (Bitmap  *bitmapPtr,  LPoint  pt) ; 

返り 値は パレ ッ ト コード。 


$A1B1  GMCalcMask 


引 

数 

long 

srcimgPtr 

変換 元の ビッ ト イメージへの ポイ ンタ 

long 

destlmgPtr 

変換 後の ビット イメージへの ポインタ 

word 

srcLineBytes 

変換 元の ビッ ト イメージの 横の バイト 数 

word 

destLineBvtes 

変換 後の ビッ トイ メージ の 横の バイト 数 

word 

width 

ビッ ト イメージの X 方向の サイズ 

word 

height 

ビッ ト イメージの y 方向の サイズ 

返り 値 ► 

DO.L 

リザルト コ ー ド 

AO.L 

変換 後の ビット イメージへの ポイ ンタが 返る 

機 

能 

srcImgPtr で 指定 した ビット イメ 

ージ から、 その マスクの ビッ ト イメージを 作成 

し、 destlmgPtr で 指を した ビット イ メージ レコー ドに 返す。 srcLineBytes 
と destLineBytes は 偶数で なければ ならない。 srcImgPtr と destlmgPtr 
は 同じ ポイ ンタを 指定して はいけ ない。 

すべての ポインタは、 疑似 ポインタ も 可。 

C の 関数 ►  int  GMCalcMask (uns igned  short  *srcImgPtr, 

unsigned  short  幸 destlmgPtr,  int  srcLineBytes , 
int  destLineBytes ,  int  width,  int  height) ; 

結果は short 型の ポインタ destlmgPtr で 示される ビット イメージ レコー 
ドに 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A1B2  GMCalcFrame 


引 数 

long 

srcImgPtr 

long 

destlmgPtr 

word 

srcLineBytes 

word 

destLineBytes 

word 

width 

word 

height 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

変換 元の ビッ トイ メー  ジ への ポイ ンタ 
変換 後の ビッ ト イメージへの ポインタ 
変懊 元の ビッ ト イメージの 横の バイト 数 
変換 後の ビット イ メー  ジの 横の バイト 数 
ビット イ メー ジの X 方向の サイズ 
ビッ ト イメージの y 方向の サイズ 
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AO.L  変換 後の ビッ ト イメージへの ポイ ンタが 返る 

機 能 ►  srcImgPtr で 指定した ビット イ メージ から、 その 枠の ビット イメ  ージを 作成 
し、 dest ImgPtr で ネ旨定 した ビット イ メー ジレ コード に 返す。 srcLineBytes 
と destLineBytes は 偶数で なければ ならない。 srcImgPtr と destlmgPtr 
は 同じ ポイ ンタを 指定して はいけ ない。 

すべての ポインタは、 疑似 ポインタ も 可。 

C の 関数 ►  int  GMCalcFrameimisigned  short  *srcImgPtr, 

unsigned  short  *dest ImgPtr , 11 it  srcLineBytes, 
int  destLineBytes ,  int  width,  int  height) ; 

結果は short 型の ポインタ destlmgPtr で 示される ビット イメージ レコー 
ドに 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A1B3 


SXLongMul 


引 数 ► long  bufPtr 


; 結果が 返る バッファ （8 バイ ト） への ポインタ 


long  numl  ; 符号 か ロング ワード 整数 

long  nuin2  ; 符号 か ロング ワード 整数 

返り 値 ►  A0.L  結果が 返る バッファへの ポイ ンタが 返る 

機 能 ►  numl と nmn2 の 符号が ロング ワード 整数 同 ± の 穂 （64 ビット） を、 bufP む: 
で 指定した バッファ じ 返す。 

疑似 ポインタ も 可。 

C の 関数 ►  void  幸 SXLo 打ぞ MuKvoid  *bufPtr , long  numl , long  niim2) ; 

返り 値は、 結果が 返る 2  ロング ワー ドの バッファへの ポイ ンタ。 


$A1B4 


SXFixRouna 


引 数 long  fixNum  ; 固定 小数点 数 

返り 値 ►  D0.W  整数 

機 能 ►  fixNum で 指定した 固定 小数点 数の 小数 部を 四捨五入して 整数に 変換す る。 
C の 関数 ►  int  SXFixRound ( 1 ong  fixNum) ; 

返り 値は 四擒五 入した 結果。 


$A1B6 


SXFixMul 


引 数 ► 1011 良 
long 

返り 値 ►  DO.L 


f ixNumi 
f ixNum2 
礫の 固定 小数点 数 
$7FFFFFFF  : オー ノス ーフ〇 • 


固定 小数点 数 1 
固定 小数点 数 2 
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$80000000  : アンダー フロー 

機 能 ►  fixNuml と FixNum2 の 2 つの 固定 小数点 数の 積を 返す。 

C の 関数 ► long  SXFixMul (long  fixNuml,  long  f ixNum2) ; 

返り 値は 稍、 または 才 ー バー/ ア ン ダー フローを 意味す る 数値。 


$A1B7 

SXFixDiv 

引 数*^ 

word 

numl  ; 符号 付ワー ド 整数 値 1 

word 

num2  ; 符号 イ寸ワ ー ド 整数 値 2 

返り 値 ► 

DO.L 

商の 固定 小数点 数 

$7FFFFFFF  : ゼロで 除算を 行った 

機能- 

numl 

子 nuin2 を 計算し、 商を 固定 小数点 数で 返す。 

C の 関数 ► 

long  SXFixDj v(int  numl, int  1111 in2) ; 

返り 値は 商、 また は ゼロ で 除算 を 巧った ことを 意味す る 数値。 

$A1B8 

GMGetFontTable 

引 数 

なし 

返り 値 ► 

D0.L 

0 

A0.L 

フォント テーブルの アド レス 

(A0) 

12 ドッ トキ 角 ASCII 

4(A0) .L 

12 ドット 全角 特殊 

8 (AO) .L 

16 ドット 半角 ASCII 

12 (AO) .L 

16 ドッ ト 半角 外字 

16 (AO) .L 

16 ドット 1/4 角 ASCII 

20 (AO) .L 

16 ドット 1/4 角 ASCII 

24 (AO) .L 

16 ドット 1/4 角 ASCII 

28 (AO) .L 

16 ドッ ト全巧 非 漢字 

32 (AO) .L 

16 ドッ ト 全角 第 1 水準 

36 (AO) .L 

16 ドッ ト 全角 第 2 水準 

40 (AO) .L 

16 ドッ ト 全角 外字 

44 (AO) .L 

16 ドット 全 巧 特殊 

48 (AO) .L 

24 ド ット 半ち ASCII 

52(A0) .L 

24 ドッ ト 半角 外字 

56 (AO) .L 

24 ドット 1/4 角 ASCII 

60 (AO) .L 

24 ドット 1/4 角 ASCII 

64 (AO) .L 

24 ドット 1/4 角 ASCII 

68 (AO) .L 

24 ドッ ト 全角 非 漢字 

72 (AO) .L 

24 ドッ ト 全ち 第 1 水準 

76 (AO) .L 

24 ドッ ト 全角 第 2 水準 

80 (AO) .L 

24 ドッ ト全巧 外字 

84 (AO) .L 

24 ドット 全角 特殊 

機 能 ►  フォントの 格納され ている アドレスの テーブルを 返す。 

C の 関数 ►  unsigned  char  ***GMGe が 〇 打 void) ; 

301 


グラフマン 


返り 値は フォン ト テーブルへの ポイ ンタ。 


$A1B9 


GMCopyStdProc 


引 数 ► long  gProcTbl  ; 描画 エントリ テー ブルを 返す バッファ （$40 

バイト） のア ドレス 

返り 値 ►  D0.L  0 

A0.L  結果が 返る バッファの ア ドレス 

機 能 >  gProcTbl で 指定した バッファに 標準 描画 エン ト リ テー ブルを 作成す る。 

C の 関数 ►  void  GMCopyStdProc ( int  (**gProcTbl)  〇 ) ; 

返り 値は ない。 


$A1BA 


GMStrZWidth 


引数 ► long 
返り 値 ►  D0.L 


strZPtr  ;ASCIIZ 型の 文字列への ポインタ 

結果/ リ ザル トコ ー ド 


上位 ワード 

イタリック width 

下位 ワード 

width 

機 能 ►  StrZPtr で 指定した 文字列の 横幅を、 々レント グラフ レコー ド 内の フォント 
関係の メ ンバ におって 求める。 

疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ► 1011 良  GMStrZWidth  (const  char  *strZPtr) ; 

返り 値は 上位 ワー ドが イ タ リック で 描画した 場合の 横幅、 下位 ワー ドが 通常の 
横幅。 エラーが 発生した 場合は リザルト コード。 


$A1BB 

GMTransImg 

引 数- 

long 

srcBitmapPtr 

; コピー 元の ビットマップ レコー ドへの ポイ 

ンタ 

long 

destBitmapPtr 

; コピ ー 先の ビットマップ レコ ー ドへの ポイ 
ンタ 

long 

srcRectPtr 

; コピー 元の レク タング ルレ コードへの ポイ 

ンタ 

long 

dest 托 ectPtr 

; コピー 先の レク タング ルレ コードへの ポイ 

ンタ 

返り 値 ► 

DO.L 

リ ザル トコー ド 

機 能 ►  異なる タイプの スクリ ーン間 （srcBitmapPtr で 指を される ビットマップから 
destBitmapPtr で 指定され る ビットマップ） で、 ビット イメー ジのコ ピーを 
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行う。 コピー 元の ビットマップ 上の srcRectPtr で 示される レク タング ル 内 
部を コピー 先の ビットマップ 上の destRectPtr で 示される レク タング ル 内 
部に コピーす るが、 両レク タング ルの サイズが 異なる 場合、 拡大/縮小が 巧-われ 
る。 

コピー 先の ビットマップが々 レントの 場合、 グラフ レク タング ル、 ビジ ブルリ ー 
ジョ ンで クリッ ピン グが斤 われる。 

再配置が 発生す る。 

C の 関数 ►  int  GM Transimg ( B i t map  *srcBitinapPtr ,  Bitmap 

幸 destBit 皿 apPtr ,  Rect  幸 srcRectPtr,  Rect  幸 destRectPtr) ; 

返り 値は リ ザル トコー ド。 


$A1BC  GMFillRImg 


引 数 ► long  rectlmgPtr  ; レク タング ルイ メー ジ レコー ドへの ポインタ 

long  pt  ; 描画 時に 左上と なる ポイント 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  rectlmgPtr で 指定され る テキスト タイプ • 1 ぺージ のレク タング ルイ メージ 
を、 ペン モードに 従って 描画す る。 揣画 位置は pt で 指定す る。 

再配置が 発生す る。 

C  の 関数 ►  int  GMFillRImg  (Rect  Img  ♦rectlmgPtr,  LPoint  pt) ; 

返り 値は り ザル トコ ー ド。 


$A1BD  GMFilllmg 


引 数 ►  long  imgPtr  ; イメージ レコー ド への ポイ ンタ 

long  rectPtr  ; 揃 画 位置、 範囲を 示す レク タン グル レコー 

ドへの ポイ ンタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  imgPtr で 指定され る テキスト タイプ • 1 ページの イ メージ を、 ペン モードに 
おって 揃 画する。 描画 位置、 範瞄は rectPtr で 指定す る。 

再配置が 発生す る。 

C  の 関数 ►  int  GMFilllmg  (unsigned  short  *imgPtr ,  Rect  れ ectPtr) ; 

返り 値は リザ ル トコード。 


$A1BE 

GMSlidedRgn 

引 数- 

long 

destRgnHdl 

; 結果が 返る リー ジョン レコ ー ドへの ハン ドル 

long 

srcRgnHdl 

; 移動す る リージ ョ ンレ コー ドへの ハン ドル 

long 

pt 

； 移動 量を 意味す る ポイント 
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返り 値 ►  DO.L  リザルト コード 

機能 ►  srcRgnHdl で 指定 される リージョンを pt で 指定 される 移動 量 だけ 相対 移動 
し、 その 軌跡を destRgnHdl にリー ジョンと して 返す。 

再配置が 発生す る。 

C の 関数 ►  int  GM&MedRg •打 （R%ion  ** destRgnHdl , Region  ♦♦srcRgnHdl, 
LPoint  pt) ; 

結果は、 Region 型の ハンドル destRgnHdl で 示される リージョン レコ'- ド 
じ 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A1BF  GMPaintRgn 


引 

数 

long 

rgnHdl 

; 結果が 返る リージョン レコ ー ドへの ハンドル 

long 

bitmapPtr 

; ビッ ト マップ レコ ー ドへの ポイ ンタ 

long 

pt 

； 走査を 開始す る ポイント 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

結果が 返る リージ; 

ヨン レコ ー ド への ハン ドル 

機 

能 

bitmapPtr て •指定した ビッ 

ト マップの ポイント、 pt 周辺の 同じ 色の 領域を 

rgnHdl 

で 指を された リージ 

ョ ンじ 返す。 

再配置が 発生す る。 

C の 関数 ►  int  GMPaintRgn  (Region  **rgnHdl,  Bitmao  *bitmapPtr ,  LPoint 

pt) ; 

結果は Region 型の ハンドル rgnHdl で 示された リージョン レコードに 格 
納 される。 

返り 値は リ ザル トコ ー ド。 


$A1C0  GMSetR  併  Li  丘  e 


引 数 ►  word  length  ; リ ージョ ン データの 1 巧の 最大値 

返り 値 ►  D0.L  前 の 嚴大値 

機 能 ► リージョン データの 1 斤の 煎 大 バイ ト 数を length に 設定す る。 length は 
娘大 $200 までの 偶数で、 0 を 指定す ると 初期が 態に 戻る。 

C の 関数 ►  int  GMSetRgnLine ( int  length) ; 

返 り 値は 前の 最大値。 


$A1C1  GMGetRgnLine 


引 数 ►  なし 

返り 値 >  D0.L  現在 設定され ている 1 巧の 最大 バイ ト数 
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機 能 ► リージョン データの 1 斤の 最大 バイト 数を 返す。 
C の 関数 ►  int  GMGetRgnLine (void) ; 

返り 値は 最大 バイ ト 数。 


$A1C2  GMInitGraphMode 


引 数 ►  word  scrMode  ; 画面 モード 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  scrMode で 指定した 画面 モー ドに あわせて ビットマップ や グラフ レコードの 
初期値を 設定す る。 scrMode で 指定す るのは、 I0CS  $10  _CRTM0D で 指定 
する 値と 同等。 

C の 関数 ►  int  GMInitGraphModednt  scrMode) ; 

返り 値は リ ザル トコ ー ド。 


$A1C3  GMCurFont 


引数 ►  なし 

返り 値 ►  D0.L  リザルト コード 

A0 .  L  フォント レコ ー ド への ハンドル 

機 能 ►  システムが 内部 で 使用 する コールな の で 使用 禁止。 

カレント グラフ レコードと フォント レコ ー ドを 上ヒ較 して、 状態が 変化して いる 
場合は フ ォン トレ コー ドを 作り 直す。 

再配置が 発生す る。 

C  の 関数 ►  int  GMCurFont  (void) ; 

返り 値は リ ザル トコー ド。 


$A1C4  GMGetS crnSize 


引 数  >  なし 

返り 値 ►  D0.L  画面の 縦横の サイズを 意味す る ポイント 

機能 >  現在、 設定され ている 願面の サイズを 返す。 

C の 関数 ►  LPoint  GMGetScrnSizeivoid') ; 

返り 備は サイズを 意味す る ポイント。 


$A1C5  GMExgGraph 


引 数 ►  long  graphPtr  ; グラフ レコードへの ポインタ 

返り 値 D0.L  0 

A0.L  前の カレン ト グラフ レコードへの ポイ ンタ 
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機能 ►  $A131  GMSetGraph と 同祿 に、 graphPtr で 指定す る グラフ レコー ドを々 レ 

ン ト じする。 それまでの々 レン ト グラフ レコ ー ドへの ポイ ンタが 返る。 

C の 関数 ►  Graph  * GMExgGraph ( Gr aph  *graphPtr) ; 

返り 値は 前の々 レン ト グラフ レコードへの ポイ ンタ。 


$A1C6  GMExgBitmap 


引 数 ► long  bitmapPtr  ; ビットマップ レコー ドへの ポインタ 

返り 値 ►  D0.L  0 

A0.L  前の ビッ ト マップ レコードへの ポイ ンタ 

機 能 ►  々レント グラフ レコードに bitmapPtr で 指定した ビットマップ レコー ドを 
セッ ト する。 それ ま での ビッ ト マップ レコ ー ドへの ポインタ が 返る。 

C の 関数 ►  Bitmap  *  GMExgBi  tmap  (  B  it  map  *bitmapPtr) ; 

返り 値は 前の ビッ ト マップ レコ ー ドへの ポイ ンタ。 


$A1C7  GMGetBitmaD 


引 数  >  なし 
返り 値 ►  D0.L  0 

AO.L  ビットマップ レコ ー ドへの ポインタ 

機 能 ►  カレント グラフ レコー ドに セットされ ている ビッ ト マップ レコー ドへの ポ イン 
夕を 返す。 

C の 関数 ►  Bitmap  *GMGetBitmap (void) ; 

返り 値は ビッ ト マップ レコードへの ポイ ンタ。 


$A1C8  GMCalcBitmap 


引 数 ►  long  bitmapPtr  ; ビットマップ レコー ドへの ポインタ 

返り 値 ►  D0.L  リザルト コード 

A0.L  ビットマップ レコ ー ドへの ポイ ンタ 

機 能 ►  bitmapPtr で 指定した ビットマップ レコー ドの 内容を 再 計算す る。 具体的に 
は、 bmKind,  bmRect を もとにして line,  page を 計算す る。 

C の 関数 ►  int  GMCalcBitmap  (Bitmap  *bitmapPtr) ; 

返り 値は リ ザル トコー ド。 


$A1C9  GMCalcScrnSize 


引 数 ►  long  bitmapPtr  ; ビッ ト マップ レコー ド への ポイ ンタ 

返り 値 ►  DO.L  ビッ ト マップが 必要と する バイ ト数 
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機 能 ►  bitmapPtr でネ 旨ました ビットマップが 必要と する メモリの バイト 数を 計算す る。 
C  の 関数 ► long  GMCaJcScr 打  Size  (Bitmap  ♦bitmapPtr) ; 

返り 値は ビット マッ プが 必要 とする メモリの バイト 数。 


$A1CA  GMNewBits 


引 

数 ►  word 

scrKind  ; 

スク リーン タイプ 

long 

rectPtr  ; 

ビッ ツの 大きさ を 示す レ クタ ン グルレ コー 

ドへの ポイ ンタ 

word 

る Page  ; 

アクセス ページ （テキス ト タイプの 場合） 

返り 値 ►  D0.L 

リ ザル トコ ー ド 

AO.L 

ビッ ツ への ハン ドル 

機 

負 長 ►  rectPtr 

で 示した 大きさを 持つ、 

scrKind の タイプの ビッツ を 作成す る。 

ビッツ 内の ビットマップ レコードは base を 除いて ネ刀期 化される。 ビッツ 内の 
イメージ データ は 初期化 さ れ ない。 

再配置が 発生す る。 

C の 関数 ►  Bits  ** GMNewBits ( int  scrKind,Rect  *rectPtr , int  aPaige) ; 

返り 値は ビッ ツ への ハン ドル。 


$A1CB  GMDisposeBits 


引 数 ► long  bitsHdl  ; ビツツ への ハンドル 

返り 値 ►  D0.L  0 

機能 >  bitsHdl で 指定した ビッツ を 廃棄す る。 

C  の 関数 ►  void  GMDisposeBits  (Bits  **bitsHdl) ; 

返り 値は ない。 


$A1CC  GMLockBits 


引 数 ►  long  bitsHdl  ; ビッツ への ハンドル 

返り 値 ►  D0.L  リザルト コード 

A0.L  ビツ ツ への ハン ドル 

機 能 ►  bitsHdl で 指定した ビッツ を ロックし、 ロック レベルを 一 1 する。 
C の 関数 ►  int  GMLockBi ts (Bits  **bitsHdl) ; 

返り 値は リ ザル トコー ド。 


$A1CD  GMUnlockBits 
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引 数 ► long 


bitsHdl 


; ビッ ツ への ハン ドル 
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返り 値 ►  DO.L  リザルト コード 

AO.L  ビツ ツ への ハン ドル 

機 能 ►  bitsHdl で 指定した ビッツ を アンロックし、 ロック レベルを +1 する。 
C の 関数 ►  int  GMUnlockBi ts (Bits  ♦♦bitsHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A1CE 


GMItalicRect 


引 数 ► 1011 良  rectPtr 


レ クタ ン グルレ コー ドへの ポイ ンタ 


返り 値 I 


D0.L 


リ ザル ト コード 


機 能 ►  rectPtr で 指を した レク タング ルを イタリックの 文字を 傾ける のと 同じ 比率 
だけ 傾け、 々レント グラフ レコードに 描画す る。 描画 モードは フォント モード 
ではなく、 ペン モードが 参照され る。 

C の 関数 ►  int  GMItalicRect (Rect  *rectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A1CF 


GMItalicRgn 


引 数- 


返り 値 I 


long 

long 

DO.L 

AO.L 


rgnHdl 

rectPtr 

リ ザル トコー ド 
リ ー ジョ ンレ コ- 


リー  ジョン  レコー  ドへの ハン ドル 
レ クタ ン グルレ コー ドへの ポイ ンタ 


ドへの ハン ドル 


機 能 ►  rectPtr で 指定した レク タング ルを イタリックの 文字を 傾ける のと 同じ 比率 
だけ 傾けた 領域を、 rgnHdl で 指定され た リージョン レコー ドに 返す。 
再配置が 発生す る。 

C の 関数 ►  int  GM む a/icJRg •打 （Fl^ion  **rgnHdl,  Rect  れ ectPtr) ; 

返り 値は リ ザル トコード。 


$A1D0 


GMFreeBits 


弓 I  数 ►  long  bitsHdl  ; ビッツ への ハンドル 

返り 値 ►  DO.L  0 

AO.L  ビッ ツ への ハン ドル 

機 自長 ►  bitsHdl で 指定した ビッツ の ロック レベルを 強制的に 0 にして アンロック する。 
C の 関数 ►  void  GMFreeBi ts ( B it s  **bitsHdl) ; 

很 I) 値は ない。 
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$A1D1  GMCalcGraph 


引 数 ► long  graphPtr  ; グラフ レコー ドの ポインタ 

返り 値 ►  D0.L  リザルト コード 

A0.L  グラフ レコ ー ドへの ポイ ンタ 

機 能 ►  graphPtr で 指定した グラフ レコードに セットされ ている ビットマップの 情報 
を もとに グラフ レコー ドの 内容を 巧 計算す る。 ビジ ブル リージョン、 クリップ 
リ ージョ ン 等が 作成され ていなかった 場合、 作成す る。 

再配置が 発生す る。 

C の 関数 ►  int  GMCalcGraph  (Graph  *graphPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A1D2  GMPackImage 


引 

数- 

long 

destPtr 

; 結果が 納められる バッファの ア ドレス 

long 

srcPtr 

; 元 データの先頭 ア ドレス 

long 

srcLen 

； 元 データの バイト 数 

返り 値 ► 

DO.L 

圧縮 結果の バイト 数/ リ ザル トコ ー ド 

AO.L 

結果が 納められる バッ 

ファの 終端 +1 

機 

能 ► 

srcPtr, 

srcLen で 与* えた メモリ の 内を を ラン レングス 法で 圧縮し、 destPtr 

で 指定した バッファ じ 格納す る。 バイ ト 単位で 同じ データが 3 バイ トの J：- 連続 
した 場合に 圧縮を 巧う ので、 圧縮の 結果 得られる データの サイズは、 最悪の 場 
合、 srcLen+((srcLen+127)/127) バイ ト となる。 

C の 関数 ► Ion 長  GMPadcJma がい oid  *destPtr ,  void  *srcPtr , 
long  srcLen; ; 

結果は、 void 型の ポインタ destPtr で 示される バッファに 格納され る。 
返り 値は 店 縮 結果の バイト 数、 ま たは リ ザル トコ ー ド。 


$A1D3  GMUnpackImage 


引 数 


返り 値 


機 能- 


long  destPtr  ; 結果が 納められる バッファの アドレス 

long  srcPtr  ; 圧縮 デー タの 先頭 アドレス 

long  srcLen  ; 圧縮 データ 展開 後の バイ ト数 

DO.L  展 I 調した バイ ト 数/リザ ル トコード 

AO.L  圧縮 デ ー タの バッファ の 終端 +1 

srcPtr ,  srcLe 打で 与えた 圧縮 デー タを destPtr で 指定され た バッファ じ 
展關 する 


C の 関数 ►  int  GMUn packimage (void  *destPtr ,  void  *srcPtr , 
long  srcLen) ; 

結果は、 void 型の ポインタ destPtr で 示される バッファに 格納され る。 
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返り 値は、 展開した バイ ト数 または リザルト コード。 


$A1D4 


GMAdiustPt 


引 数 ■ 


pt 

rectPtr 


ポイント 

レク タン グル レコ ’ 


ドへの ポインタ 


long 
long 

DO.L  調整した 結果の ポイント 

pt で 指定した ポイントが rectPtr で 指定した レク タング ル 内に 納まる よう 
に 調整す る。 最初から レク タング ルの 内部に ある 場合は 何も しない。 

C の 関数 ►  LPoint  GMAdj ustPt ( LPo int  pt,  Rect  ♦rectPtr) ; 

返り 値は ポイント。 


返り 値 I 
機能 I 


$A1D5 


GMPutImg 


引 

数 

long 

imgPtr 

long 

rectPtr 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

機 

能- 

imgPtr で 指定 した イ メー 

C の 関数 • 


; イメージ レコードへの ポインタ 
； レク タング ルレ コードへの ポインタ 

■ジ を々 レント グラフ レコードの rectPtr で 指定 
された 位置と 大きさで 描画す る。 イメージの タイプは テキスト タイプ、 描画 モー 
ドは PSET に 固定。 描画 ページは々 レント ビッ ト マップの アクセス ページで 決 
をされ る。 

int  GMPu timg ( un s igne d  short  *i 皿 gPtr,  Rect  *rectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A1D6 


GMCenterRect 


引 数 ► long  destRectPtr 


long 

long 

word 


srcRectPtr 

sizePt 

mode 


結果が 返る レ クタ ン グルレ コー ドへの ポイ 
ンタ 

元になる レク タング ルレ コー ドへの ポイ ンタ 

新しく 作る レク タン グルの 大きさ を 意味す 
る ポイント 

レ クタ ン グルが はみ出した 場合の 化理 


0 


元になる レク タング ルと 新しく 作る 
レク タング ルの 中心を あわせる 
新しく 作る レク タン グルの 左上の 座 
標が 必ず 元の レク タング ルの 内側に 
納まる よう にす る 
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返り 値 DO.L  結果 


0 

ヌル レク タン グルになった 

1 

正常終了 

-1 

エラー 

AO.L  結果が 返る レク タング ルレ コー ドへの ポイ ンタ 

機能 ►  srcRectPtr で ホ旨定 する レク タング ルの 中央に sizePt で 指定す る 大きさ 
のレク タング ルを 作成し、 destRectPtr に 格納す る。 srcRectPtr が ヌル 
レク タング ルの 場合、 結果 も ヌル レク タング ルと なる。 

C の 関数 ►  int  GMCenterRect (Re ct  *destRectPtr ,  Rect  *srcRectPtr , 
LPoint  sizePt ,  int  mode); 

返り 値は 結果を 意味す る 数値。 


$A1D7  GMScrewRect 


引 数 ►  long  rectPtr  ; レク タング ルレ コードへの ポインタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  rectPtr で 指定した レク タング ルを 外形と する 擬似 ダイアログを、 カレント 
グラフ レコ ー ドに 描画す る。 

レ クタ ン グルと して （XS,  ys)-(xe,  ye) を 指定した 場合、 ビスの 位置は 
(XS+4,  ys+4)+(xs+14,  ys+14)、 (xe-15,  ys+4)— (xe— 5,  ys+14)、 

(xs+4,  ye— 15)— (xs+14,  ye— 5)、 (xe— 15,  ye— 15)— (xe— 5,  ye— 5) 

の 4 々所と なる。 

C の 関数 ►  int  GMScrewRect  (Rect  れ ectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A1D8  GMAndRectRgn 


引 

数- 

long 

destRgnhal 

; 結果が 返る リージョン レコ ー ドへの ハンドル 

Ion 良 

srcRgnHdl 

; リ ー ジョン レコ ー ド への ハン ドル 

long 

srcRectPtr 

; レク タング ルレ コードへの ポインタ 

返り 値 ► 

DO.L 

リザルト コ ー ド 

AO.L 

結果が 返る リージ ョ 

ンレ コー ドへの ハン ドル 

が 

13c 

能- 

srcRectPtr で 指定した レク タング ルと srcRgnHdl で 指定した リー ジョン 

の AND をと り、 結果を destRgnHdl にりージョン として 格納す る。 共通 
部分がない 場合、 結果は ヌル リージョン となる。 

再配置が 発生す る。 

C の 関数 ►  int  GMAndRectRgn  (Region  幸* destRgnHdl , Region  *srcRgnHdl, 
Rect  *src 氏 ectPtr) ; 

結果は、 Region 型の ハンドル destRgnHdl で 示される リージョン レコード 
に 格納され る。 
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$A1D9  GMOrRectRgn 


引 数 


返り 値 ► 


機 能 


long 

destRgnHdl 

; 結果が 返る リ_ ジョン レコー ドへの ハンドル 

long 

srcRgnHdl 

; リー ジョン レコー ドへの ハンドル 

long 

srcRectPtr 

; レク タング ル レコー ドへの ポインタ 

DO.L 

リザルト コ ー ド 

AO.L 

結果が 返る リ ージョ 

ンレ コー ドへの ハン ドル 

srcRectPtr で 指定した レク タング ルと srcRgnHdl で 指定した リージョン 
の 0 民 をと り、 結果を destRgnHdl にリー ジョンと して 格納す る。 
再配置が 発生す る。 


C の 関数 ►  int  GAi'OfjRecLRg •打 （Il%ion  **destRgnHdl  ,R%ion  **srcRgnHdl, 
Rect  *srcRectPtr) ; 


結果は、 Region 型の ハンドル destRgnHdl で 示される りージョン レコード 
に 格納され る。 


返り 値は リ ザル トコ ー ド。 


$A1DA  GMDiffRectRgn 


引 

数- 

long 

destRgnHdl 

; 結果が 返る り'- ジョン レコー ドへの ハンドル 

long 

srcRgnHdl 

; りー ジョン レコー ドへの ハンドル 

long 

srcRectPtr 

; レク タング ルレ コードへの ポインタ 

返り 値 ► 

DO.L 

リザルト コ ー ド 

AO.L 

結果が 返る リージ 

ョン レコ ー ド への ハン ドル 

機 

能 

srcRgnHdl で 指定した リー 

ジョンの 内侧 で、 srcRectPtr で 指定した レク 

タ ン グルの 外側の 部分を ボ め、 結果を destRgnHdl に リージョンと して 格納 
する。 

再配置が 発生す る。 

C の 関数 ►  int  GMDiffRectRg ■打 （R%i on  **destRg 打 Hdl ,R%ion  幸* srcRgnHdl, 
Rect  *srcRectPtr) ; 

結果は、 Region 型の ハンドル destRgnHdl で 示される リージョン レコー ド 
に 格納され る。 

返り 値は リザルト コード。 


$A1DB  GMXorRectRgn 


弓 1 数 ► long  destRgnHdl 

long  srcRgnhal 


; 結果が 返る リー ジョン レコードへの ハン ドル 
.リ — ジョン レコ ー ド への ハンドル 
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long  srcRectPtr  ; レク タング ル レコー ドへの ホ インタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

A0.L  結果が 返る リージョン レコー ドへの ハン ドル 

機 能 ►  srcRectPtr で 指定した レク タング ルと srcRgnHdl で 指を した リー ジョン 
の X0 民 をと り、 結果を 过 estRgnHdl じ リージョン として 格納す る。 
再配置が 発生す る。 

C の 関数 ►  int  GAlXorRectRgn (Region  **destRgnHdl , Region  ** srcRgnHdl, 
Rect  ♦srcRectPtr) ; 

結果は、 Region 型の ハンドル destRgnHdl で 示される リー ジョン レコー ド 
に 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A1DC  GMCharKind 


引 数 ►  word  ch  ; 文字コード （ASCII コード/シフト JIS コ 

— ド） 

返り 値 ►  D0.L  文字 種 コード 

機能- ch で 指定した 文字の 種類を 返す。 存在し ない 文字コードを 指定した 場合、 ミッ 
シング キャラクタ となり、 全角 特殊と して 分類され る。 

文字 種 コードの 分類は 下のと おり。 


文字 種 コード 

文字の 種類 

コー ドの 範囲 

0 

半角 ASCII 

$00 〜 $FF,  $8000 〜 $80FF 

1 

半角 外字 

$F400 〜 $F5FF 

2 

1/4 巧 上 か 

$F000 〜 $F1FF 

3 

1/4 巧 下 か 

$F200 〜 $F3FF 

4 

未を 義 

5 

全角 非 漢字 

$8140 〜 $84BE 

6 

金 巧 第 1 水準 漢字 

$889F  〜 $989E 

7 

金 巧 第 2 水準 漢字 

$989F  〜 $EB9E 

8 

全角 外字 

$ 邸 9F  〜 $EC9E 

9 

を 巧 特殊 

$84BF  〜 $889E,  $F600 〜 $FFFF 

C の 関数 ►  int  GMCharKind ( int  ch) ; 
返り 値は 文字 種 コード。 


$A1DD 

GMDif f RgnRect 

引 数 

long 

destRgnHdl 

; 結果が 返る リ ー ジョン レコ ー ド への ハンドル 

long 

srcRectPtr 

; レク タング ル レコー ドへの ポインタ 

long 

srcRgnHdl 

; リ _ ジョン レコ ー ド への ハン ドル 

返り 値 

DO.L 

リ ザル トコ ー ド 

AO.L 

結果が 返る りー ジョ 

ンレ コー ドへの ハン ドル 

srcRectPtr で 指定 した レク タング ルの 巧侧 で、 srcRgnHdl で 指定 したり一 
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ジョ ンの 外側の 部分を 求め、 結果を destRgnHdl にリー ジョンと して 格納す 
る。 

再配置が 発生す る。 

C の 関数 ►  int  GMDifFRgnRect (Region  **destRgnHdl,  Rect  *srcRectPtr , 
Region  幸* srcRgnHdl) ; 

結果は、 R%ion 型の ハンドル destRgnHdl で 示される リージョン レコード 
じ 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A1E0 

GMAddFont 

引 数- 

long 

fLink  ; フォン トリ ン クのア ドレス 

返り 値 ► 

DO.L 

リザルト コ ー ド 

機 能- 

フ オン ト マンの 追加 じよ り 使用禁止。 

f  Link 

で 指定した フォン トリ ンクを システムに 追加す る。 

$A1E1 

GMRemoveFont 

引数- 

long 

fKind  ; フォント カ インド 

返り 値 > 

DO.L 

リザルト コ ー ド 

機 能 ► 

フ オン ト マンの 追加 じよ り 使用禁止。 

fKind 

で 指定した フォント カ イン ドと して 登録され ている フォントを 取り外す。 

$A1E2 

GMGetFontLink 

引 数 ► 

なし 

返り 値 ► 

DO.L 

フォン トリ ンクの 先頭が 納められ ている ア ドレス 

AO.L 

フォン トリ ンクの 先頭が 納められ ている ア ドレス 

機能 > 

フォン ト マンの 追加 じよ り 使用禁止。 

フォン トリ ンクの 先頭が 格納され ている ア ドレスを 返す。 

$A1E3 

GMGetHProcTbl 

引 数 なし 

返り 値 ►  D0.L  水平 ホ 苗 画の 初期化 ルーチンの テーブルの ア ドレス 

AO.L  水平 描画の 初期化 ルーチンの テーブルの ア ドレス 

機 能 ►  水平 描闺の 初期化 ルーチンの テーブルを 返す。 

C の 関数 ►  int  (** の Vf Get 妊 Proc 了] bK void) )  0  ; 

返り 値は、 水平 描画の 初期化 ルーチンの テーブルへの ポイ ンタ。 
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$A1E6 

GMGetStdProcTbl 

引 数 

なし 

返り 値*^ 

DO.L  標準 描画 ルーチンの テーブルの ア ドレス 

A0.L  標準 描画 ルー チンの テーブルの ア ドレス 

機能- 

標準 描画 ルー チ ンの テー ブルを 返す。 

C の 関数 ►  int  (** GMGetStdProcTbJ (void) ) () ; 

返リ 値は、 標準 揃 画 ルー チンの テーブルへの ポインタ。 

$A1E7 

GMGetFontProcTbl 

引 数 

なし 

返り 値 ► 

D0.L  文字 描画 ルーチンの テー ブルの アド レス 

A0.L  义字揣 画 ルーチンの テーブルの ア ドレス 

機 能 ► 

文字 描画 ルーチンの テー ブルを 返す。 

C の 関数 ►  int  (**GMCetFontProcTbJ(void) ) () ; 

返り 値は、 义字揣 画 ルーチンの テーブルへの ポイ ンタ。 

$A1E8 

GMGe t RgnPr 〇  cTbl 

引 数 

なし 

返り 値 ► 

DO.L  リ ー ジョン 1 巧 •演算 ル ー チ ンのテ ー ブルの ア ドレス 

A0.L  リージョン 1 巧 演算 ルー チンの テーブルの ア ドレス 

機能- 

りー ジョン 1 斤 演算 ルー チンの テーブルを 返す。 

C の 関数 ► 

void  (**GMGetRgnProcTbI (void)) () ; 

返り 値は、 リー ジョン 1 斤 演算 ルー チンの テーブルへの ポイ ンタ。 

$A1E9 

GMDrawGsOne 

1  E.O 

引 数 ► long  gsEnvPtr  ; スクリプト 環境 レコードへの ポインタ 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  gsEnvPtr で 指定した スクリプト 環境 レコードの 内を じ 従って スクリプトを 1 
コマンド 実行す る。 $A19C  GMDrawScript の 下請け コール。 

スクリプトの コマンド （64 番 iU 降） を 追加す る 場合、 この コー ルの ベクタを フッ 
ク する。 

再配置が 発生す る。 

C の 関数 ►  int  GMDrawGsOne ( GSOneEnv  *gsEnvPtr) ; 

返り 値は リザ ル トコ ー ド。 
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$A1EA  GMPtlnlmg 


Eao 


引 数 ► 

long 

rectlmgPtr 

; レク タング ルイ メー ジレ コードへの ポインタ 

long 

pt 

； 調べる 座標を 意睐 する ポイント 

word 

page 

; ページを 号 

返り 値 ► 

DO.L 

結果 

0 

座標は イメージの なかにはない 

1 

座標は イメージ のなかに ある 

-1 

エラー 

機能 ►  pt で 指定し た 座標が、 rectlmgPtr で 指定 した テキスト タイプの レク タング 
ル イメージ のなか じある かどう かを 調べる。 このと き、 page です 旨定 した ペー 
ジ で、 指定した 座標の 上下 左右の ドットが ON になって いれば、 イ メージ 内部 
と 判断され る。 

C の 関数 ►  int  GMPtlnlmg (Rectlmg  *rectImgPtr ,  LPoint  pt,  int  psige) ; 
返り 値は 結果 を 意味す る 数値。 


$A1EB  GMFrameNPoly 


巧 〇 


引 数 ►  long  npListPtr  ; ポリゴン リストへの ポインタ 

long  npEnvPtr  ; ポリ ゴン 環境 レコー ド への ポイ ンタ 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  ニュー ポリゴンの 枠を 描画す る。 

再配置が 発生す る。 

C の 関数 ►  int  GMFrameNPoly (\iPoly  *npListPtr,  NPolyEnv  *npEnvPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A1EC 

GMFillNPoly 

1  2.0 

B  引数 

long 

npListPtr 

; ポリ ゴン リス ト への ポイ ンタ 

long 

npEnvPtr 

; ポリ ゴン 環境 レコー ドへの ポインタ 

H  返り 値 

DO.L 

リ ザル トコー ド 

機 能 ►  ニュー ポリゴンの 内部を 塗りつ ぶす。 
再配置が 発生す る。 


C の 関数 ►  int  GMFillNPoly mPo ly  幸 npListPtr,  NPolyEnv  *npEnvPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A1ED  GMNPolyFrRgn 


Ce.o 
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; 結果が 返る リー ジョン レコー ドへの ハンドル 
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long 

npListPtr 

; ポリ ゴン リス ト への ポインタ 

long 

npEnvPtr 

; ポリゴン 環境 レコ ー ド への ポインタ 

long 

rectPtr 

; レク タング ル レコー ドへの ポインタ 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

結果が 返る リージ ョ 

ン レコ ー ド への ハンドル 

機能 

npListPtr と npEnvPtr で 表現され る ニュー ポリゴンの 枠を 意味す るリ 

ジョンを 求めて rgnHdl で 示される リージョン レコードに 格納す る。 このと 
き、 rectPtr で 示される レク タング ルで クリ ッ ピン グを 行う。 
rgnHdl として 0 を 指定した 場合、 グラフマンが メモリを 確保す る。 
rectPtr として 0 を 指定した 場合、 クリッピングを 斤わない。 

再配置が 発生す る。 

C  の 関数 ►  R%ion  *  *  GMNPolyFrRgn  (Region  **rgnHdl  ,NPoly  *npListPtr , 
NPolyEnv  幸 npE 打 vPtr,  Rect  幸 rectPtr) ; 

返り 値は リ ー ジョ ン レコ ー ド への ハンドル。 

エラーが 発生した 場合、 NULL が 返る。 


$A1EE  GMNPolyFlRgn 


引 

数- 

Ion 良 

rgnHdl 

; 結果が 返る リ ージョ ン レコードへの ハンドル 

long 

npListPtr 

; ポリ ゴン リス ト への ポイ ンタ 

long 

np じ nvPtr 

; ポリゴン 環境 レコ ー ド への ポインタ 

long 

rectPtr 

; レク タング ル レコー ドへの ポインタ 

返り 値 

DO.L 

リ ザル トコー ド 

AO.L 

結果が 返る リージ ョ 

ン レコー ドへの ハン ドル 

機 

能*^ 

npListPtr と npEnvPtr で 表現され る ニュー ポリゴンの 巧 部を 意味す るり一 

ジョンを ホめ て rgnHdl で 示される リー ジョン レコー ドに 格納す る。 このと 
き、 rectPtr で 示される レク タング ルで クリ ッ ピン グを 巧う。 

閉じて いない ニュー ポリ ゴン は、 始 点と 終点を 直線で 結んで 閉じる。 
rgnHdl として 0 を 指定した 場合、 グラフマンが メモリを 確保す る。 
rectPtr として 0 を 指定した 場合、 クリッ ピン グを 斤わない。 

再配置が 発生す る。 

C の 関数 ►  Region  **GAlIVPofyFlRgTKR%ion  **rgnHdl ， NPoly  *npListPtr , 
NPolyEnv  幸 npErivPtr,  Rect  本 rectPtr) ; 

返り 値は リー ジョン レコー ドへの ハン ドル。 

エラーが 発生した 場合、 NULL が 返る。 


$A1EF  GMPtInNPoly 


引 数 ► long 
long 


npListPtr 

npEnvPtr 


; ポリ ゴン リス ト への ポイ ンタ 
; ポリ ゴン 環境 レコードへの ポインタ 
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long  pt  ; 調べる 座標を 意味す る ポイント 

返り 値 ►  D0.L  結果 

0  |~ 座標は ニュー ポリゴンの なかにはない 
_1 座標は ニュー ポリゴン のなかに ある _ 

機 能 ►  pt で 指定した 座標が npListP む:， npEnvPtr で 指定した ニュー ポリ ブンの 
内部に あるか どうかを 調べる。 

この コールは 高速 化の ため 厳密な チて ック を 行わない ので、 厳密 さが 要求され 
る 場合は $A1EE  GMNPolyFlRgn と $A168  GMPtlnRgn を 使用す る 必要 
が ある。 

C の 関数 ►  BOOLEAN  GMPtInNPoly ( NPo ly  *npListPtr ,  NPolyEnv  *npEiivPtr , 
LPoint  pt) ; 

返り 値は 結果を 意味す る 数値。 


$A1F0  GMPtOnNPoly 


引 数- 

long 

npListPtr 

; ポリ ゴン リス ト への ポイ ンタ 

long 

npEnvPtr 

; ポリ ゴン 環境 レコ ー ドへの ポインタ 

long 

pt 

； 調べる 座標を 意味す る ポイント 

返り 値 ► 

DO.L 

結果 

0  座標は ニュー ポリ ゴンの 線 上には ない 
1 座 樵は ニュー ポリ ゴンの 線 上に ある 


機 能 ►  pt で 指定した 座標が npListPtr, 哗 EnvPtr で 指定した ニュー ポリゴン 
の 線 上 じある かどう かを 調べる。 

この コールは 高速 化の ため 厳密な チて ックを 斤わない ので、 厳密 さが 要ボ され 
る 場合は $A1ED  GMNPolyFrRgn と $A168  GMPtlnRgn を 使用す る 必要 
が ある。 

C の 関数 ►  BOOLEAN  GMPtOnNPoly ( NP 〇 1  y  *npListPtr,  NPolyEnv  *npEnvPtr , 
LPoint  pt) ; 

返り 値は 結果を 意味す る 数値。 


$A1F1  GMRecordScript 


n 己 己. 


引 数- 

long 

dataHdl 

; スク リプト デー タへの ハン ドル 

long 

offset 

; スク リプト 先頭からの オフ セッ 

long 

length 

； 記録す る バイト 数 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

機 能 ►  dataHdl で 指定した メモリ ブロック 中の 先頭から offset バイト 目から length 
バイトを、 々レント グラフ レコー ドで 記録 中の スク リプト に 記録す る。 
再配置が 発生す る。 

C の 関数 ►  int  GMRecordScript (Eandl e  dataHdl,  long  offset , long 


length) ; 

返り 値は リ ザル トコ ー ド。 


グラフマン 


$A1F2  GMNLineRel 


G 己 □ 


引 数 long  pt  ; 終点を 示す ポイント （相が 位置） 

long  npEnvPtr  ; ポリ ゴン 環境 レコード への ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能  >  ペンの 現在 位 蘆から pt で 示した 相が 位置の ポイントまで、 npEnvPtr で 示さ 
れる ポリ ゴン 環境 レコードの 内容に 従って ラインを 引く。 

再配置が 発生す る。 

C の 関数 ►  int  GMNLineRei (LPoint  pt,  NPolyEnv  *npEnvPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A1F3  GMNLine 


0.0 


引 数 ► long  pt  ; 終点を 示す ポイント （絶対位置） 

long  npEnvPtr  ; ポリ ゴン 環境 レコード への ポインタ 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  ペンの 現在 位置から pt で 示した ポイントまで、 npEnvPtr で 示される ポリ ゴ 
ン 環境 レコ ー ドの 内容に 従って ライ ンを 引く。 

再配置が 発生す る。 

C の 関数 ►  int  GMJVLine (LPoint  pt,  NPolyEnv  *npEnvPtr) ; 

返り 値は リ ザル トコー ド。 


$A1F4  GMRecordPoly 


引 数 ► long  pt  ; 記録す る 座標を 意味す る ポイント 

返り 値 ►  DO.L  リ ザル トコー ド 
機 能- pt で 示された 座標を ポリゴンに 記録す る。 

最ネ 刀の 点の 場合は、 現在の ペンの 座標と あわせて 2 点 分、 記録す る。 
C の 関数 ►  int  GMRecordPoly ( LPo int  pt) ; 

返り 値は り ザル トコー ド。 


$A455  GMDitherlmg 


Cai 


引 数 ►  ：Long 
long 


imgPtr 

destRectPtr 


; イメージ レコードへの ポインタ 
; 描画 位置、 範閣を 示す レク タング ルレ コー 
ドへの ポイ ンタ 
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返り 値 ■ 
機能 I 


long 

hv 

； イメージの サイ ズを 指定す る ホイ ント 

word 

田 ode 

； 揣画 モード 

word 

page 

； ページ 数 

long 

dPattern 

; ディ ザ パ ターン レコ ー ドへの ポイ ンタ 

DO.L 

リザルト コ ー ド 

imgPtr で 指定され る page ぺージ の テキス ト タイ プのイ メー ジ を、 destRect 
Ptr で 指定 される 位 霜に モノクロ ディ ザ 変換 を 巧いながら 揃 画する。 mode て" 
指定した 揣画 モー ドが 使用され る。 

元になる イメージの サイズは ポイント hv で 指定す る。 拡大/縮小が 発生した 場 
合、 拡大率 じよって ディ ザハ ° ターン レコード 中の 適切な ディ ザハ ° ターン が 使用 
される。 

ディ ザ パターン レコードの 内容は U 下の とおり。 
typedef  struct  { 

/♦ 瑕大 倍率 （2 なら 2 倍までの 拖乂 がに 使用され る）*/ 
short  mag  ; 

/* ぺージ 数 （3 なら 8 色み の イメージが 続く）*/ 
short  page ; 

/*  unsigned  short  img[] ;  白、 ライト グレー、 ダー ク グレー、 黒... 

にが 応 する 16x16 の テキス ト タイプ 1 ページの イメージが 並ぶ*/ 

}DPatPac ; 
typedef  struct  { 

/*  総 バィト 数 （4  +  (4  +  32  X  2。） X  m)  ♦/ 

/*  n は ぺージ 数。  771 は パ ターン 数 （m  < 16)  */ 
long  recordSize; 

/*  DPatPac  patterns; 1 組の デイ ザ パ ターン パック 

吼 恵したい 倍率の 数 だけ 並ぶ*/ 

}DPattern; 


dPattern として 0 を 指定した 場合、 デフォルトの ディ ザ パターンが 使用され 
る。 デフォルトの ディ ザ パターンは、 I' ヨ〜 黄の 8 色 （3 ページ） に 対応す る 
パターンが！〜 2 倍と 2 〜 5 倍の 2 セッ トで 構成され ている。 

スク リプト に 記録され る。 

再配置が 発を する。 

C の 関数 ►  int  GMDi therlmg ( uns i gne d  short  幸 imgPtr,Rect  本 destRectPtr , 
LPoint  hv,  short  皿 ode,  short  page ,  DPattern  *dPatter 打)； 

返り 値は リ ザル トコー ド。 


$A540 


GMSetFlattness 


I  S.O 


引 数*"  word 
返り 値 ►  DO.L 


theFla で tness 
前の 近似 誤差 判定 値 


； 近似 誤差 判を 値 


グラフマン 
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機能 ► ベジ ュ、 B スプラインの 化理で 参照され る 似 誤差 判定 値を セットす る。 

似 誤差 判定 値の 単位は、 グラフマンの 座標系の ポイント。 

デフォルトは 1。 

C の 関数 ►  int  GMSetFlattness ( int  theFlattness) ; 

返り 値は 前の 近似 誤差 判定 値。 


$A541  GMGetFlattness  し 呂 .〇 


引数 >  なし 

返り 値 D0.L  近似 誤差 判定 値 

機能 現在の 近似 誤差 判を 値を 返す。 

C の 関数 ►  int  GAJGetFlattness (void) ; 
返り 値は 近似 誤差 判定 値。 


$A542  GMSetBSDepth 


引 数 ►  word  theDepth  ; 最大 巧 帰 階数 

返り 値 >  D0.L  前の 最大 再帰 階数 

機能 ►  プリント マン 用 じつき 使用禁止。 

ベジ ュ、 B スプラインの 化理で 参照され る 最大 再帰 階数を セッ ト する。 


$A543  GMGetBSDepth 


引数- なし 

返り 値- D0.L  現を の 最大 再帰 階数 

機能 ►  プリント マン 用 じつき 使用禁止。 
現を の 最大 再帰 階数 を 返す。 


$A544 

GMDrawBezier 

1  ao 

引 数 

long 

clPt 

； 方向 点 1 を 意味す る ポイント 

long 

c2Pt 

; 方向 点 2 を 意味す る ポイント 

long 

a2Pt 

; 終点を 惹睐 する ポイント 

返り 値 

DO.L 

両端 点を 含む、 

補間され たポ イン トの数 

機 能 ►  ペンの 現を 位置を 起点と して、 clPt、 c2Pt を 経て a2Pt に 至る 3 次の ベジ 
曲線を 1 セ グメン ト 描画す る。 

スク リプト に 記録され る。 

ポリ ゴンに 記録され る。 
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C の 関数 ►  int  GMDrawBezier ( LP 〇 i nt  clPt ,  LPoint  c2Pt ,  LPoint  a2Pt) ; 
返り 値は 補間され たポイ ントの 数。 


$A545 

GMDrawBSpline 

1  E.O 

引 数- 

long 

cPt 

; 中間 点を 意味す る ポイント 

long 

a2Pt 

; 終点を 意味す る ポイント 

返り 値*^ 

DO.L 

両端 点を 含む、 補間され た ポイントの 数 

機能 >  ペンの 現在 位置を 起点と して、 cPt を 経て a2Pt に 至る 2 次の B スプライン 
曲線を 1 セ グメン ト揃 画する。 

スク リプト に 記録され る。 

ポリ ゴンじ 記録され る。 

C の 関数 ►  int  GMDrawBSplineiLPo int  cPt ,  LPoint  a2Pt) ; 

返り 値は 補間され たポイ ントの 数。 


$A546  GMSplitBezier  I  g.p 


引 数 ► long 

ClPt 

； 方向 点 1 を 意味す る ポイント 

long 

c2Pt 

； 方向 点 2 を 意味す る ポイント 

long 

a2Pt 

； 終点を 意; 味す る ポイント 

long 

aDivision 

； 分割 比を 意味す る 固定 小数 

long 

aSplited 

; 結果を 格納す る バッファへの ポインタ 

返り 値 ►  DO.L 

リザ ノレ トコ ー ド 

機 能 ►  ペンの 現を 位置を 起点と して、 clPt,  c2Pt を 経て a2Pl: に 至る 3 次の ベジエ 
曲線 1 セグメント を 分割 比 aDivision (整数 部 16 ビット + 小数 部 16 ビッ 
卜） で々 熟ん、 その 2 セグメントの ポイント 列を aSplited で 示される バッ 
ファに 格納す る。 

C の 関数 ►  int  GMSpli tBezier (LPoint  clPt ,  LPoint  c2Pt ,  LPoint  a2Pt , 
long  aDivision,  Sp 丄 tBz  幸 aSplited) ; 

返り 値は リ ザル トコ ー ド。 


$A547 

GMSplitBSpline 

1  a.o 

引 数 

long 

cPt 

; 中間 点を 意味す る ポイント 

long 

a2Pt 

; 終点を 意味す る ポイント 

long 

aDivision 

; 分割 比を 意味す る 固を 小数 

long 

aSplited 

; 結果を 格納す る バッファへの ポインタ 

返り 値 

DO.L 

リ ザル トコ ー ド 

機能 ►  ペンの 現在 位置を 起点と して、 cPt を 経て a2Pt じ 至る 2 次の B スプライン 
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曲線 1 セグメント を か 割 比 aDivision  (整数 部 16 ビット + 小数 部 16 ビッ 
卜） で々 割し、 その 2 セ グメン ト のポイ ント 列を aSplited で 示される バッ 
ファに 格納す る。 

C の 関数 ►  int  GMSplitBSpline ( LPo int  cPt ,LPoint  a2Pt , long  aDivision, 
SpltBSp  *aSplited) ; 

返り 値は リザ ル トコ ー ド。 


$A548  GMPt 日 打 Bezier 


d 包 〇 


引数- long 
long 
long 
long 

返り 値 ►  DO . L 


ClPt 

； 方向 点 1 を 意味す るポ イン 

c2Pt 

； 方向 点 2 を 意味す るポ イン 

a2Pt 

; 終点を 意味す る ポイント 

pt 

； 調べる 点を 意味す るポ イン 

指定 した 点に よる 曲線の々 割 比を 意味す る 固定 小数 
負の 数の 場合は エラー。 


機 能 ►  pt で 指定した ポイントが、 現在の ペン 位置、 clPt,  c2Pt,  a2Pt で 指定し 
た 3 次の ベジ 卫 曲線 1 セ グメン ト上 にある かどう かを 調べる。 曲線 上 じある 場 
合は、 その ポイ ント によって セ グメン トが 分割され る 比率を 固定 小数 （整数 部 
16 ビット + 小数 部 16 ビット） で 返す。 


C  の 関数 ► long  GMPtOnBezier  (LPoint  clPt ,  LPo  int  c2Pt ,  LPoint  a2Pt , 
LPo int  pt) ; 

返り 値は、 か 割 比を 意味す る 固定 小数 または 負の 数。 


$A549  GMPtOnBSpline 


引 

数- 

long 

cPt 

； 中間 点を 意味す る ポイント 

long 

a2Pt 

； 終点を 意味す る ポイント 

long 

pt 

; 調べる 点を 意味す る ポイント 

返り 値 ► 

DO.L 

指を した 点じよ る 曲線の 分割 比を 意味す る 固定 小数 

負の 数の 場合は エラー。 

機 

能*^ 

pt で ネ旨定 した ポイントが、 

現在の ペン 位置、 cPt,  a2Pt で 指定した 2 ホの 

B スプライン 曲線 1 セ グメン ト上 にある かどう かを 調べる。 曲線 上 じある 場合 
は、 その ポイ ント によって セ グメン トが 分割され る 比率を 固定 小数 （整数 部 16 
ビット + 小数 部 16 ビット） で 返す。 

C  の 関数 ► long  GMPtOnBSpline  (LPoint  cPt ,  LPoint  a2Pt ,  LPoint  pt) ; 
返り 値は、 分割 比を 意味す る 固定 小数 または 負の 数。 


グラフマン 


$A54A  GMSetBSError 


引 数 ► long  errConst  ; 判定 範囲 誤差を 意味す る 固を 小数 

返り 値 ►  DO. L  前の errConst 
機能 >  ユーザ 使用禁止 コー ル。 

$A548  GMPtOnBezier,  $A549  GMPtOnBSpline  で 参照され る 反 較範圆 誤 
差を errConst じする。 

デフォルトは $c000o 


$A54B  GMGetBSError 


Es. 百 


引数- なし 

返り 値 ►  D0.L  現在の errConst 
機能 ►  ユーザ 使用禁止 コー ル。 

$A548  GMPtOnBezier,  $A549  GMPtOnBSpline  で 参照され る 現在の 反較 
範囲 誤差を 返す。 


$A550  GMSetGSDraw 


Ee.o 


引数- word 
long 

返り 値 ►  DO . L 
AO.L 


gsNo  ; スクリプト コマン ドを 号 （0 〜 63) 

procPtr  ; 描画 ルー チンへの ポイ ンタ 

リ ザル トコード 

前の 描画 ルー チンへの ポイ ンタ 


機 能 ►  gsNo で 指定した スクリプト コマンドの 描画 ルーチンを 登録す る。 

C  の 関数 ►  int  (  *  GMSetGSDraw^  int  gsNo,  int  (*procPtr)  ()))  (GSOneEnv 
幸 gsEnvPtr) ; 

返り 値は、 前の 描 晒 ルーチンへの ポインタ。 

負の 数の 場合は エラー。 


$A551  GMGetGSDraw 


引 

数 

word 

gsNo  ; スクリプト コマン ド悉号 （0 〜 63) 

返り 値 ■- 

D0.L 

リザルト コ _ ド 

AO.L 

現在の 描画 ル ー チンへの ポイ ンタ 

機 

能 ► 

gsNo で 指定した スク リ プトコ マン ドの 描画 ルー チンへの ポイ ンタを 返す。 

C  の 関数 ►  int  (  *  GMGetGSDraw  (±nt  gsNo) )  (GSOneEnv  *gsEnvPtr) ; 
返り 値は 揃 画 ルー チンへの ポイ ンタ。 

負の 数の 場合は エラー。 


グラフマン 


$A552  GMSetGSGet 


L2.0 


引 数 ►  word 
long 

返り 値 ►  DO . L 
AO.L 


gsNo  ; スクリプト コマン ド 番号の〜 63) 

procPtr  ; オフ セッ ト化理 ルーチンへの ポインタ 

リザルト コ ー ド 

前の オフ セッ ト化理 ル ー チンへの ポイ ンタ 


機能 ►  gsNo で 指定した スク リ プトコ マン ドの オフ セッ ト化理 ルーチンを 登録す る。 
C の 関数 ►  int  GMSetGSGet ( int  gsNo ,  int  (*procPtr) () ) ; 

返り 値は 処理 ルーチンへの ポイ ンタ。 

負の 数の 場合は エラー 


$A553  GMGetGSGet 


引 数 ►  word  良 sNo  ; スクリプト コマンド 番号 （0 〜 63) 

返り 値 ►  D0.L  リ ザル トコ ー ド 


A0.L  現在の オフセット 化理 ルー チンへの ポイ ンタ 
機 能 ► 良 sNo で 指定した スクリプト コマンドの オフセット 化理 ルーチンを 返す。 
C  の 関数 ►  int  ( *  GMGetGSGet  (  int  gsNo)) () ; 

返り 値は 化理 ルーチンへの ポイ ンタ。 


負の 数の 場合は エラー。 


$A554  GMTileRImg 


Cab 


弓 I 数 ► Ion 邑  rectlmgPtr  ; レク タング ルイ メー ジレ コードへの ポインタ 

long  rectPtr  ; レク タング ル レコー ドへの ポインタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  rectPtr で 指を した レク タング ルの 範閣 巧に、 rectlmgPtr で 指定 した レク 
タング ル イメージを 敷きつ める。 イメージの スクリ ーンカ インドは、 々レント 
グラフ レコー ドに セット されて いる ビッ ト マップと 同じで なければ ならない。 
スク リプト に 記録され る。 

C の 関数 ►  int  GMTileRInig(^Rect Img  *rectImgPtr ,  Rect  *rectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A555  GMTilelmg 


Cao 


引 数 ► long 
long 
long 

返り 値 ►  DO . L 


imgPtr 

rectPtr 

sizePt 

リ ザル ト コード 


イメ  ー ジ レコ ー ド への ポインタ 
レク タン グル レコー ドへの ポインタ 
ビッ トイ メージ の サイズを 意味す る ポイント 
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機能 ►  rectPtr で 指定した レク タング ルの 範圃 内に、 imgPtr で 指定した イメージ 
を 敷きつ める。 イメ ージの 縦横の サイズは sizePt で 指定す る。 イメージの 
スクリ ーンカ インドは、 々レント グラフ レコードに セット されて いる ビッ トマ ッ 
プと 同じで なければ ならない。 

スク リプト じ 記録され る。 

C の 関数 ►  int  GMTiieJmgCunsigned  short  *inigPtr,  Rect  *rectPtr , 
LPoint  sizePt) ; 

返り 値は リ ザル トコ ー ド。 


$A556  GMSetDispOff set  I  a.o 


引 数 ► long  ofsPt  ; 縦横の オフセットを 意味す る ポイント 

返り 値 ►  なし 

機 能 >  グラフィック ウィンドウ 専用 コール じつき、 使用禁止。 

グラフィック 画面の ハー ドウ ェ アスク ロ  ー ルの オフ セッ ト 値と して of  sPt を 
セッ ト する。 

C  の 関数 ►  void  GMSetDispOff  set  (LPoint  of  sPt) ; 

返り 値は ない。 


$A557  GMGetDispOf f set  I  3.0 


引 数 なし 

返り 値 ►  DO.L  オフセット テーブルの アドレス 

AO.L  オフ セッ ト テーブルの ア ドレス 


(AO) .L 

ページ# 0 の オフセット を 意味す る ポイント 

4(A0) .L 

ぺ ー ジ #1 の オフセットを 恵 味す る ポイント 

8(A0) .L 

ぺージ 林 2 の オフセット を 意味す る ポイント 

12(A0) .L 

ページ# 3 の オフセット を 意味す る ポイント 

機 能 ►  グラフィック 画面の ハー ドウ エア スクロールの オフセット テーブルを 返す。 
C の 関数 ►  LPoint  *GMGetDispOffset (void) ; 

返り 値は オフ セッ ト テーブルへの ポインタ。 


$A558  GMTestScrKindG  I  3.0 


引 数 ►  word  scrKind  ; スクリーン カ インド 

返り 値 ►  DO.L  結果 


0 

使用 不可 

1 

使用可能 

機 能 ►  現在の グラフィック 画面の モー ドで scrKind で 指定した グラフィック 系 ビット マ 
ップが 使用可能 かどう かを 調べる。 scrKind として 指定で きる のは G.GRP(l) 
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または G_GRX(4) のみ。 

C の 関数 ►  int  GMTestScrKind G ( int  scrKind) ; 

返り 値は、 使用可能 かどう かを 意味す る 数値。 


$A559  GMGetScrKindG  I  日 •日 


引 数 ►  なし 

返り 値 ►  DO.L  現を の グラフィック 画面の 種類 

機 能 ►  現在の グラフィック 画面の 種類を 返す。 今のところ、 G_GRP(1) または G_GRX(4) 
が 返る。 

C の 関数 ►  int  GMGetScrKindG  (void) ; 

返り 値は 現在の グラ フィック 画面の 種類。 


$A55D  GMGetGraphMode  I  3.Q 


引数 ►  なし 

返り 値 ►  D0.L  画面 モード 

機 能 $A1C2  GMInitGraphMode で 初期化 時に 指定され た 画面 モードを 返す。 
C の 関数 ►  int  GMGetGraphModeiv old) ; 

返り 値は 画面 モード。 


$A55E  GMSetPalet  I  3.0 


引 

数- 

long 

palHdl 

; ノ 、。レツ トノ 、ン ドノ レ 

返り 値 ► 

DO.L 

前の々 レン ト パレ 

ッ ト ハン ドル 

AO.L 

前の カ レン ト パレ 

ッ ト ハン ドル 

機 

能 

カレント 

パレ ッ ト ハン ドルを 

palHdl に 設定す る。 

C の 関数 ►  Palet  **GMSetPaiet(Palet  **palHdl) ; 

返り 値は パレ ッ ト ハン ドル。 


$A55F  GMGetPalet  |_3.口 


引 数- なし 

返り 値 ►  D0.L  現在の々 レント パレット ハンドル 

A0.L  現在の々 レン ト パレ ッ ト ハン ドル 

機 能 ►  現在の カレント パレット ハンドルを 返す。 

C の 関数 ►  Palet  **GMGetPaiet (void) ; 

返り 値は パレ ッ ト ハン ドル。 
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$A560 


GMCopy2 


I  3.0 


引 数 I 


返り 値 ► 
機 能- 


Ion 良 

rscID 

long 

srcBitmapPtr 

long 

destBitmapPtr 

long 

srcRectPtr 

long 

destRectPtr 

1011 呂 

srcPalHdl 

long 

destPalHdl 

long 

pal am し en 

long 

palamPtr 

DO.L 

リ ザル トコー ド 

色 変換 モジュールの リソース ID 
コ ピー 元ビッ ト マップ レコ ー ドへの ポイ ンタ 
コ ピー 先ビッ ト マップ レコ ー ドへの ポイ ンタ 
コ ピー元 レ クタ ン グル レコー ドへの ポイ ンタ 

コ ピー 先 レ クタ ン グル レコー ドへの ポイ ンタ 

コピー 元の パレ ッ ト ハンドル 
コ ピー 先の パレ ッ ト ハン ドル 
パラメー タの バイ ト数 
パラメータへの ポイ ンタ 


rscID で 指定した 色 変換 モジ ュー ルを 用いて 色 変换を 斤いながら ビッ ト マップ 
間で 矩形 領域の コピーを 斤う。一 1 を 指定す ると、 デフォルトの 色 変換 モジ ュー 
ルが 使用され る。 

srcBitmapPtr で 指定した ビットマップの、 srcRectPtr で 指定した 範囲 
を、 destBitmapPtr の destRectPtr じ コピー する。 コピー 元と コピー 先 
でレク タン グルの サイ ズが 異なる 場合は、 ホ 広大/縮小を 斤う。 

色 変換 モジュール がか 加 情報を 要求す る 場合、 palamLen,  palamPtr で 指定 
する。 

々レント グラフ レコードの ビッ ト マップへの コ ピーの 場合、 スクリプト じ 記録 
される。 

C の 関数 ►  int  GMCopy 2 (int  rscID,  Bitmap  *srcBitmapPtr , 

Bitmap  *destBitmapPtr , Rect  幸 srcRectPtr ,Rect  *destRectPtr , 
Palet  * 幸 srcPalHdl,  Palet  幸* destPalHdl , int  palamLen, 
int  本 palamPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A562 


GMMake  Gr  dB  i  t  map 


lao 


引 数- 
返り 値*^ 


機能 I 


なし 

DO.L 


エラ、 


AO.L 


=  0 

0  テ ネスト タイプの ビッ ト マップ レコ ー ドへの ポイ ンタ 

DO と同樣 

画面 モー ドに 応じた グラフィック タイプの ビッ ト マップ レコー ドを 作成し、 々レ 
ント グラフ レコー ドに セッ ト する。 前に セッ ト されて いた ビッ ト マップ レコー 
ドへの ポイ ンタか •返される。 

々レント グラフ レコー ドに セット されて いる ビッ ト マップは テキスト タイプで 
なければ ならない。 
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セット される グラフィック タイプの ビットマップは、 必要が なくなったら $A02F 
MMPtrDispose で 廃棄す る 必要が ある。 

C の 関数 ►  Bitmap  *GMMakeGrpBitmap(vo±d) ; 

返り 値は ビッ ト マップ レコー ドへの ポイ ンタ。 


$A563 

GMDrawScript2 

1 3.0 

引 数- 

long  scriptHdl 

; スクリ プト への ハン ドル 

long  rectPtr 

; レク タング ル レコー ドへの ポインタ 

long  paletHdl 

; ノ、 ° レツ ト ハン ドル 

返り 値 

DO . L  リザ ル トコー ド 

機能- 

scriptHdl で 示される カラ- 

- 情報の 含まれた スク リプト (ver.2) を 描画す る。 

従来の スク リプト （ver.l) も 描画 可能。 

描画 中は、 paletHdl が カレント パレ ッ ト じセッ ト される。 

C の 関数 ►  int  GMDrawScri pt2 (GScript  **scriptHdl,  Rect  *rectPtr , 

Palet  * 幸 paletHdl) ; 

返り 値は リ ザル トコ ー ド。 

$A564 

GMRecordVer 

1  3.Q 

引 数 

word  scriptVer 

; スク リプ トのバ ージョ ン 番号 

返り 値 

DO  •  L  リ ザル トコード 

機 能 > 

アプリケーションは 使用禁止。 

現在 記録 中の スクリプト の バー 

- ジョン 番号を scriptVer にす る。 

C の 関数 > 

int  GMRecordVer ( int  scriptVer) ; 

返り 値は リ ザル トコ ー ド。 

$A565 

GMForeRGB 

1  3.0 

引 数 ► long  rgbPtr  ;  RGB レコー ドへの ポインタ 

返り 値 ►  D0.L  々レント グラフ レコー ドに セット した 値 
負の 数の 場合は エラー 

機 能 ►  々レント パレットを 参照して、 rgbPtr で 指定した をに 近い 色を フォア グラウ 
ン ド々 ラーと して セッ ト する。 

RGB レコードの 形式は の 《 下のと おり。 
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typedef  struct  CRGB  { 

unsigned  short  cRed; 

unsigned  short  cGreen; 

unsigned  short  cBlue ; 

unsigned  short  cAlpha; 

}  CRGB; 


/*  ホ 0-65535  */ 
/ 幸 緑 0-6553 日*/ 
/*  青 0-6553 巨*/ 
/♦ 披張 用*/ 


スク リプト に 記録され る。 

C の 関数 ►  int  GMForeRGB (CRGB  れ gbPtr) ; 

返り 値は、 々レント グラフ レコー ドに セットした 値。 


$A566 


GMBackRGB 


I  3.0 


引 数- 
返り 値 ► 

機 能 ► 


C の 関数 I 


long  rgbPtr  ;  RGB レコー ドへの ポイ ンタ 

D0.L  カレント グラフ レコード じ セット した 値 

負の 数の 場合は エラー 

カレント パレットを 参照して、 rgbPtr で 指定した 色に 近い 色を バック グラウ 
ン ド々 ラーと して セッ ト する。 

スク リプト じ 記録され る。 

int  GMBackRGB  (CRGB  *rgbPtr) ; 

返り 値は、 カレント グラフ レコードに セットした 値。 


$A567 


GMRecEnv 


I  3.0 


弓 I 数 ►  long  bitmapPtr  ; ビッ ト マップ レコ ー ドへの ポイ ンタ 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  記録 中の スクリプトに bitmapPtr で 指定した ビットマップ レコードの 情報 
を 記録す る。 bitmapPtr として 0 を 指定す ると、 々レント グラフ レコードの 
ビッ ト マップを 記録す る。 

$A199  GMOpenScript 時には、 自動的に この コールが 呼び出される。 

C  の 関数 ►  int  GMRecEnv  (Bitmap  *bitmapPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A568 


GMRecPalet 


I  3.0 


弓 I  数 ► long  paletHdl 


返り 値 ►  DO.L 


リ ザル トコ ー ド 


パレ ッ ト ハン ドル 


機 能 ►  記録 中の スクリプトに paletHdl で 指ました パレットの 情報を 記録す る £ 
paletHdl として 0 を棺定 すると、 々レント パレットを 記録す る。 

C の 関数 ►  int  GMRecPalet (Peilet  **paletHdl) ; 

返り 値は リ ザル トコ ー ド。 


ク ラフ 7 ン 
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$A569  GMFillRImg2 


引 

数- 

long 

rectlmgPtr 

; レク タング ル イメージ レコードへの ポインタ 

long 

destRectPtr 

; レク タング ルレ コードへの ポインタ 

word 

面 ode 

； 描画 モード 

返り 値 

DO.L 

リザルト コ ー ド 

機 

能 

recti 皿 gPtr で 示される レク タング ル イメージ （テキスト タイプ、 1 ページ） 

を、 フォアグラウンド カラー、 バックグラウンド カラーに 従って 田 ode で 指定 
した 描画 モードで 揃 画する。 皿 ode は フォン トモー ドに 準拠す る。 

元の 大きさと destRectPtr で 示される レク タング ルの 大きさが 異なる 場合、 
拡 火/縮小 する。 

スク リプト に 記録され る。 

C の 関数 ►  int  GMFillRImg2 ( Re c t Img  *rectImgPtr ,  Rect  *destRectPtr , 
int  皿 ode) ; 

返り 値は リ ザル トコ ー ド。 


$A56A 

GMFillImg2 

引 数- 

long 

imgPtr 

long 

destRectPtr 

word 

width 

word 

height 

word 

mode 

返り 値 ► 

DO.L 

リ ザル トコー ド 

イメ ー  ジ レコ ー ド への ポインタ 
レ クタ ン グルレ コー ドへの ポイ ンタ 
イメ ー ジの X 方向の ドッ ト数 
イ メー  ジの y 方向の ドット 数 
描画 モード 


機 能 ►  imgPtr で 示された ビット イメージ （テキスト タイフ °、 1 ページ） を フォア グ 


ラウンド カラー、 バックグラウンド々 ラーに 従って mode で 指定した 描画 モー 
ドで 描画す る。  田 ode は フォント モードに 準 挑す る。 


width,  height で 示される 元の 大きさと、 destRectPtr で 示される レク 
タング ルの 大きさが 異なる 場合、 拡大/論 = 小を 巧う。 

スク リプト に 記録され る。 

C の 関数 ►  int  GMFillImg2 (uns igned  short  幸 imgPtr,  Rect  幸 destRectPtr , 
int  width,  int  height,  int  mode) ; 


返り 値は リ ザル トコ ー ド。 


$A56B  GMSetPutID 


rao 


引 数 ►  word  rscID  ; 色変换 モジ ュー ルの リソース ID 

返り 値 ►  DO.L  前のを 変換 モジュールの ID 

機能 >  デフォルトの 色 変換 モジ ュー ルを rscID で 指定す る。 rscID として一 1 を 
指定す ると、 現を の 色 変換 モジュールの リ ソース ID を 返す。 
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C の 関数 I 


デフォルトのを 変換 モジュールは、 スクリプト コマンド GS_PUT3 を 実行す る 
ときに 使用され る。 

デフォルトでは 0 が 設定され ている。 
int  GMSetPutID ( int  rscID) ; 

返り 値は 色 変換 モジ ュ ー ルの の。 


$A56C 


GMMakePalet 


I  3.0 


弓 I 数 ►  word  scrType  ; ビッ トマ ッ プの スク リーン タイプ 

word  aPage  ; アクセス ページ 

返り 値 ►  DO.L  リ ザル トコー ド 

A0 .  L  パレット ハンドル 

エラーの 場合は NULL 

機 能 ►  scrType で 指を された スクリーン タイプに 従って パレット ハンドルを 作成し 
て 返す。 スクリーン タイプが テキスト タイプの 場合の み が age が 意味を 持つ。 
C  の 関数 ►  Palet  *  *  GMMakePalet  (  int  scrType,  int  aPeige) ; 

返り 値は パレ ッ ト ハン ドル。 

エラーが 発生した 場合、 NULL が 返る。 


$A56D 


GMF ontRealSize 


I  3.0 


引数 ►  なし 

返り 値 ►  DO.L  フォントの サイズを 意味す る ポイント 

機 能 ►  カレント グラフ レコードに 設定され ている フォント々 インド、 フォント サイズ 
を も とに 装飾の ない フォン トの 実際の サイズを 返す。 

C の 関数 ►  LPoint  GMFontRealSize (void) ; 

返り 値は ポイント。 


$A56E 


GMGetCPDFInfo 


lao 


引 数 • 
返り 値 I 


word 

DO.L 

AO.L 


; を 変換 モ ジュールの リソース ID 


rscID 

リ ザル トコ ー ド 

色 変換 モジュール 情報 レコー ドへの ポイ ンタ 


(AO) .L 

リ ソース ID 

4(A0) 

モジ ュール 名 （ASCIIZ 型、 32 バイト） 

36 (AO) 

コメント （ASCIIZ 型、 220 バイト） 

機能 >  rscID で 指定した を 変換 モジ ュー ルに 関する 情報を 返す。 を変换 モジュール 情 
報 レコードが 必要な く なった 場合、 $A02F  MMPtrDispose で 廃棄す る 必要 
が ある。 

C の 関数 ►  Cpdfinfo  *  GMGetCPDFInfo (  int  rscID) ; 
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$A56F  GMGetCPDFList 


113.0 


引数 なし 

返り 値 ►  D0.L  を 変換 モジ ュー ルの 数/リザルト コード 

A0.L  を 変換 モジュール 情報 レコードの リス ト への ポイ ンタ 

機 能 ►  すべての 色 変換 モジ ュー ルに ついての 情報を 返す。 色 変換 モジ ュール 情報 レコー 
ドの リストは 必要が なくなった 場合、 $A02F  MMPtrDispose で 廃棄す る 必要 
が ある。 

リス トの 終端には -1L が 付加され る。 

C の 関数 ►  int  GMGetCPDFList (Cipdi Info  **list) ; 

を変换 モジュール 憎 報 レコー ドの リストへの ポインタが cpdfList 型の ポイ 
ンタ list じ 格納され る。 

返り 値は、 を 変換 モ ジュールの 数 または リ ザル トコ ー ド。 


$A570  GMScanScript  I  3.0 


引 数- 

long 

scriptHdl  ; 

スク リプト への ハン ドル 

long 

offset  ; 

調べ 始める オフセット 

word 

gsNo  ; 

スク リ プトコ マン ド 番号 

返り 値 ► 

DO.L 

スク リプト 先頭からの オフセット 

= -1  エラー 

AO.L 

スク リプト への ポインタ 

機 能 ►  scriptHdl で 指定した スクリプトの offset バイト 目から gsNo で 指定し 
た スクリプト コマンドを 探し、 その オフセットを 返す。 発見で きなかった 場合 
は一 1 力 《返る。 

C の 関数 ►  int  GMScanScript ( GS cr ipt  **scriptHdl ,int  offset, int  gsNo) ; 
返り 値は、 スク リプト 先頭からの オフ セッ ト または リザ ル ト コード。 


$A571  GMGetGSInfo 


Hao 


引 数 ► long 
返り 値 ►  DO.L 

AO.L 


scriptHdl  ; スク リフ 。卜 への ノ、 ン ドノ レ 

=  0  エラー 

0  スクリプト 情報 レコー ドへの ポインタ 

スク リプト 情報 レコー ドへの ポインタ 
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(A0) .W 

対象と する スクリーン タイプ 

2(A0) 

バウ ン ドレ クタ ン グル 

10 (AO) .W 

アクセス ページ 

12 (AO) .W 

スク リプト のバー ジョン 

14 (AO) .L 

を 体の バイト 数 

機 能 >  scriptHdl で 指定した スクリプト に関する 情報を 返す。 スクリプト 情報 レコー 
ドは 必要が なくなった 場合、 $A02F  MMPtrDispose で 廃棄す る 必要が ある。 
C の 関数 ►  Gsinfo  *GMGetGSInfo(GScript  **scriptHdl) ; 

返り 値は スク リプト 情報 レコードへの ポイ ン タ。 

エラーが 発生した 場合、 NULL が 返る。 


$A572 


GMMovePoly 


3.G 


引 数 


ポリ ゴン レコー ドへの ハン ドル 

移動 先の ポイント （絶対位置） 


long  polyHdl 

long  pt 

返り 値 ►  DO.L  リザルト コード 

機能 ►  polyHdl で 指定 した ポリゴンを、 pt で 指定 した ポイント が ホ ーム 位置に な 
るよう じ 移動させる。 

C の 関数 ►  int  GMMovePoly ( Polygon  ♦♦polyHdl,  LPoint  pt) ; 

返り 値は リ ザル トコ ー ド。 


$A573 


GMSlidePoly 


I  3.0 


引 数 


ポリ ゴン レコ ー ド への ハンドル 

移動 化の ポイント け 目が 位置） 


long  polyHdl 

long  pt 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  polyHdl で 指を した ポリゴンを、 pt で 示された 値 だけ 相対 移動させる。 
C  の 関数 ►  int  GMSlidePoly  (Polygon  ♦*polyHdl,  LPoint  pt) ; 

返り 値は リ ザル トコ ー ド。 


$A574 


GMNewBits2 


1 3.0 


引 

数 

word 

long 

word 

long 

返り 値 > 

DO.L 

AO.L 

機 

能 

rectPtr 

scrKind 

rectPtr 


； スク リーン タイプ 

; ビッッ の 大きさを 示す レク タング ルレ コ- 
ドへの ポイ ンタ 

; アクセス ページ （テキス ト タイプの 場合） 

; ベース ア ドレス 


aPage 
baseAddr 

リ ザル トコ ー ド 
ビッ ツ への ハン ドル 

機 能 ►  rectPtr で 示した-火 きさを 持つ、 scrKind の タイプの ビッッ を 作成す る。 


ク ラフ マン 
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baseAddr として 0 la 外を 指定す ると、 ビッ ツのイ メージ 領域は 確保され ず、 
ロック された 際には その ア ドレスから イメージ 領域と して 使用す る。 0 を 指定 
した 場合は $A1CA  GMNewBits と 同じ 動作を する。 

再 白 己 置が 発生す る。 

C の 関数 ►  Bits  **GMNewBits2 ( int  scrKind,Rect  *rectPtr , int  aPeige, 
int  baseAddr) ; 

返り 値は ビッ ツ への ハン ドル。 

エラーが 発生した 場合、 NULL が 返る。 


ライブラリ 

GMSetRect4 

返り 値 ► 

=  0 

エラー 

丰。 

正常終了 

機能- 

rectptr で 示される ポイ ン タのア ドレスに、 左上の 点を 

(left,  top) で、 

右下の 点を （right,  bo な 0 皿） で 与えられた 値を 持つ Rect 型を 作成す る。 

C の 関数 > 

int 

GMSetRect4 ( Re ct  *rectptr , int  left , int  top, int  right , 

int 

botto 皿）； 

ライ ブ ラリ 

GMSetRect2 

返り 値 ► 

=  0 

エラー 

丰。 

正常終了 

機 能 > 

rectptr で 示される ポインタの アドレスに、 左上の 点を ptl で、 右下の 点を 

pt2 

で 与えられた 値を 持つ Rect 型を 作成す る。 

C の 関数 ►  int 

GMSetRect2 ( Re c t  *rectptr ,  LPoint  ptl , 

LPoint  pt2) ; 

ライブラリ 

GMPtToRect 

返り 値 ► 

=  0 

エラー 

丰り 

正常終了 

機能 ► 

rectptr で 巧され る ポインタの アドレスに、 点 がし pt2 で 示された 座標 か 

ら 作られる レク タング ル Rect 型を 作成す る。 

ptl. 

pt2 の 位置 閱 係は 自由。 

C の 関数 > 

int GMPtToRect (Rect  れ ectptr,  LPoint  ptl , 

LPoint  size) ; 

ライ ブ ラリ 

GMGetRectHV 

返り 値 

=  0 

ェラー 

丰り 

縦、 横の サイズ 
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機 能 ►  rectptr でみ えられた レク タング ルの 縦、 横の サイズを 計算して 返す。 
C の 関数 ► long  GMGetRectHV (Rect  *rectptr) ; 


ライ ブ ラリ 

GMGetRectH 

返り 値 ►  =  0 

幸 0 

エラー 

横の サイズ 

機 能 >  rec 巧 れ でみ えられた レク タング ルの 横の サイズを 計算して 返す。 

C の 関数 ► long  GMGetRectH (Rect  れ ectptr) ; 

ライブラリ 

GMGetRectV 

返り 値*^  =  0 

ェラー 

牛り 

縦の サイズ 

機 能 ►  rectptr でみ えられた レク タング ルの 縦の サイズを 計算して 返す。 
C の 関数 ► long  GMGetRectV (Rect  *rectptr) ; 
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#include  《WINDOW. H> 


$A1F8  WMInit 


引 数 なし 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  ウィンド ウマンを 初期化す る。 メモリ マン、 イベント マンが 初期化され、 リ ソー 
ス ファイル 'SYSTEM .LB' が オープンされ ている 必要が ある。 

再 配屬が 発生す る。 

C の 関数 ►  int  WMInit  (void) ; 

返リ 値は リ ザル トコー ド。 


$A1F9  WMOpen 


ウィンド ウレ コー ドへの ポイ ンタ 
レ クタ ン グル レコー ドへの ポイ ンタ 
LASCII 型の 文字列への ポイ ンタ 
可ネ見 フラグ 

リ ソース ‘WDEF’ の の X 16  + オプシ 


ヨン 


オプション 

bitO 

bitl 

bit2 

bits 

ス クロ  ール バー 

クリ ップ 
ドライ ブ 表示 
サイズ ボタン 

long 

behindWinPtr 

; ウィンドウ レコー ドへの ポイ ンタ 

word 

cBttn 

; クローズ ボタン フラグ 

Ion 呂 

taskID 

； タスク ID を 号 

返り 値*^ 

DO.L 

リザルト コ ー ド 

AO.L 

ウインド ウレ コ- 

ドへの ポイ ンタ 

機 能- 

新しい 

ウ ィン  ドウを 離く。 

winPtr は、 新しく 作成す る ウイン ドウの ウィン ドウ レコー ドが 納められる ア 
ドレスを 示す。 0 を 指を すると、 ウィンド ウマンが ヒープ 上に 作成す る。 
titleLStrPtr は、 ウインドウ タイ ト ノレを 示す LASCII 型の 文字列への ポイ 
ンタ。 

visible として- 1 を 指定す ると ウィンドウは 可視と なり、 0 を 指定す ると 不 
可視と なる。 


51  巧 ► long 

long 

long 

word 

word 


win ピで r 

boundRectPtr 

titleLStrPtr 

visible 

wDefID 
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behindWinPtr は、 この ウィン ドウの 上に 表示され る ウィン ドウの レコードへ 
の ポインタを 指定す る。 -1 を 指を すると 最も 手前に、 0 を 指定す ると 最も 奥 
に 置かれる。 

cBttn として- 1 を 指定す ると クローズ ボタンを 描画す る。 0 の 場合は 描画し 
ない。 

再配置が 発生す る。 

C の 関数 ►  Window  * WMOpen (Window  *winPtr ,  Rect  *boundRectPtr , 
const  -LASCII  *titleLStrPtr ,  BOOLEAN  visible, 
int  wDefID,  Window  *behindWiiiPtr ,  BOOLEAN  cBttn, 
long  taskID) ; 

返り 値は ウィン ドウ レコー ドへの ポイ ンタ。 

エラー の 場合は NULL が 返る。 


$A1FA  WMRefer 


引 

数 

word 

windID 

; リソース 'WIND' の の 

long 

WinPtr 

; ウィンド ウレ コー ドへの ポイ ンタ 

long 

behindWinPtr 

; ウィンド ウレ コー ドへの ポイ ンタ 

返り 値 ► 

DO.L 

リ ザル トコー •ド 

AO.L 

ウインド ウレ コー 

ドへの ポイ ンタ 

機 

能 

WindID で 指ました ウィン ドウ テンプレートの 内容に 従って 新しい ウィンドウ 

を 開く。 

winPtr は、 新しく 作成す る ウイ ン ドウの ウイ ン ドウ レコー ドへの ポイ ンタを 
示す。 0 を 指定す ると、 ウインド ウマンが ヒープ 上に 作成す る。 
behindWinPtr は、 この ウイン ドウの 上に 表示され る ウイ ン ドウの レコードへ 
の ポインタを 指定す る。 -1 を 指定す ると 最も 手前に、 0 を 指定す ると 最も 奥 
に 置かれる。 

再配置が 発生す る。 

C  の 関数 ►  Window  *  WMRefer  (int  windID ,  Window  *winPtr , 

Window  *behindWinPtr) ; 

返り 値は ウイン ドウ レコ ー ドへの ポイ ンタ。 

エラー の 場合は NULL が 返る。 


$A1FB  WMClose 


引 数 ►  long  winPtr  ; ウインドウ レコー ドへの ポインタ 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 >  WinPtr で 指定した ウィンドウを 閉じ、 ウィンドウ リストから 削除す る。 
ウィンド ウレ コー ドを ヒープ 上の I 外に 作成して いた 場合に 使用す る。 
再配置が 発生す る。 


338 


C の 関数 ►  int  WMCiose (Window  *wiiiPtr) ; 
返り 値は リザ ル トコ ー ド。 


ウインド ウマン 


$A1FC 


WMDispose 


引 数 ► long  winPtr  ; ウインドウ レコー ドへの ポインタ 

返り 値 ►  D0.L  リ ザル トコー ド 

機 能 ►  WinPtr で 指定した ウィンドウを 閉じ、 ウィンドウ リストから 削除した のち、 
ウィン ドウ レコードと して 確保され ていた ブロックを 破棄す る。 

ウィンド ウレ コー ドを ヒープ 上に 作成して いた 場合に 使用す る。 

再配置が 発生す る。 

C  の 関数 ►  int  WMDispose  (Window  *winPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A1FD 


WMFind 


引 数 
返り 値 ► 


long 

D0.L 


pt  ; ポイント （グローバル 座標） 

リザ ノレ トコ ー ド I パ ー トコ — ド 


0 

ウイン ドウの 外 

1 

システム 予約 

2 

システム 予約 

3 

ウイ ン ドウ コンテンツ 

4 

ドラッグ リー ジョン 

5 

システム 予約 

6 

サイズ ボタン 

7 

クローズ ボタン 

8 

ズ ー ム ボタン （ズ ー ム イン） 

9 

ズーム ボタン （ズ ーム アウト） 

10 

システム 予約 

11 

システム 予約 

12 

システム 予約 

13 

矢 巧 

14 

クリップ (ON) 

15 

クリ ップ （OFF) 

16 

ドライブ/コン トロー ルボ タン （時計） 

AO.L  ウインドウ レコー ドへの ポイ ンタ 

機 能 ►  pt で 指定した ポイントが、 どの ウィンドウの、 どの 部分に あたる かを 調べ、 該 
当す る ウィ ン ドウ レコード への ポイ ンタと ノ、 ° ー  トコ ー ド を 返す。 

C の 関数 ►  int  WMFind (LPoint  pt,  Window  ** winPtr ) ; 

返り 値は パー トコ ー ド。 

Window 型の ポイ ンタ 変数 winPtr に、 該当する ウィンドウの ウィンド ウレ 
コー ドへの ポイ ンタが 返る。 


ウインドウ ミ 
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$A1FE  WMSelect 


引 数 ►  long  winPtr  ; ウインドウ レコードへの ポインタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  WinPtr で 指定した ウィンドウを アクティブに する。 

再配置が 発生す る。 

C  の 関数 ►  int  WMSelect  (Window  *winPtr) ; 

返り 値は リザ ル トコ ー ド。 


$A1FF  WMSelect2 


引 数 ►  long  winPtr  ; ウインドウ レコー ドへの ポインタ 

long  behindWinPtr  ; ウイ ンド ウレ コー ドへの ポイ ンタ 

返り 値 ►  DO.L  リ ザル トコー ド 

機能 ►  WinPtr で 指定 した ウィンドウを、 behindWinPtr で 指定 した ウィンドウの 後 
ろに 配置す る。 behindWinP れと して- 1 を 指定す ると 最も 手前に、 0 を 指定 
する と 最も 奥に 置かれる。 

$A1FE  WMSelect と 異なり、 サブ ウィンドウを 消 ましない。 

再配置が 発生す る。 

C の 関数 ►  int  WMSeiect2 (Window  *winPtr ,  Window  *behindWinPtr) ; 

返り 値は リザ ル トコ ー ド。 


$A 200  WMCarrv 


引 

数- 

Ion 良 

winPtr 

; ウインド ウレ コー 

ドへの ポイ ンタ 

long 

behindWinPtr 

; ウインド ウレ コー 

ドへの ポイ ンタ 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

機 

能 ■- 

WinPtr で 指定 した ウィンドウを、 behindWinPtr で 指定 した ウィンドウの 後 

ろに 配置す る。 behindWinPtr と して- 1 を 指定す ると 最も 手前に、 0 を 指定 
する と 最も 奥に 置かれる。 

再配置が 発生す る。 

C の 関数 ►  int  WMCarryCWindow  *winPtr ,  Window  *behindWinPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A201  WMShine 


引 数 ► long  winPtr 

word  value 


; ウィンド ウレ コー ドへの ポイ ンタ 

; 設定 値 
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0 

ウィンドウを イン アクティブ じ 

する 

-1 

ウィ ン ドウを アクティブ じする 

other 

ノ、 0— トコー ド 

返り 値*^  DO.L  リザルト コード 

機 能 ►  winPtr で 指定した ウィンドウの アクティブ/イン アクティブの 設定を 斤う。 複 
数の ウィン ドウを アクティブに しては ならない。 

value と して パー トコー ドを 指定した 場合は、 が応 する パー トが 反転 表示され 
る。 反較を 元に 戻す 場合は、 靑 度、 この コールで 反転させる か、 ウィンドウ 自 
体を イ ン アクティブに する。 

再配置が 発生す る。 

C の 関数 ►  int  WMSiiiiie (Window  *winPtr ,  int  value) ; 

返り 値は リ ザル トコ ー ド。 


$A202 

WMMove 

引 数- 

long 

winPtr 

; ウインド ウレ コー ドへの ポイ ンタ 

long 

pt 

; ウィン ドウの 位置を 示す ポイント （グロー 
バル 座標） 

word 

active 

; アクティブ フラグ 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

機能 ►  winPtr で 指定 した ウィン ドウを pt で 指定す る 位置に 移動す る。 その 際、 active 
が- 1 なら ウィン ドウを アクティブに してから 移動させる。 

指定した ウィン ドウが 子 ウィン ドウを 持つ 場合、 子 ウィン ドウ も 同時に 移動す 
る。 

再配置が 発生す る。 

C の 関数 ►  int  WMMove (Window  *winPtr ,  LPoint  pt,  BOOLEAN  active) ; 
返り 値は リ ザル トコ ー ド。 


$A203  WMSize 


引 

数 ► long 

WinPtr 

； ウインドウ レコー ドへの ポイ ンタ 

long 

sizePt 

; サイ ズを 示す ポイント 

word 

f Update 

; アッ プデー トフ ラグ 

返り 値 ►  DO.L 

リ ザル トコ ー ド 

機 

能 ►  winPtr で 指を した ウィン ドウの サイ ズ を、 sizePt で 示す x,  y 方向の サイズ 

に 変更す る。 Update に- 1 を 指定す ると アップ デー トイ ベントが 発生す る。 0 
の 場合、 アップデート イベントは 発生し ない。 

再配置が 発生す る。 

C  の 関数 ►  int  WMSize  (Window  *winPtr ,  LPoint  sizePt ,  BOOLEAN  f  Update) ; 


ウインドウ マン 
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返り 値は リ ザル トコ ー ド。 


$A204 

WMGrow 

引 数- 

long 

winPtr 

; ウインド ウレ コー ドへの ポイ ンタ 

long 

pt 

; アニメーション 開始 ポイント （グローバル 
座標） 

long 

rectPtr 

; サイズ 制限を 示す レク タング ルレ コードへ 
のポイ ンタ 

返り 値 ► 

DO.L 

サイ ズを 意味す るポイ ント / リザルト コード 

機 能 ►  マウスの 左 ボタン カ S 挪 されて いる 間、 マウスの 動きに サイズを あわせて winPtr 
で 指定した ウィンドウの 輪郭を 描画す る。 左 ボタンが 離された 時点で、 決定し 
た サイズを 返す。 結果 的に サイズに 変更がなかった 場合は 0 が 返る。 

通常、 pt としては マウスが 押された 座標、 つまり、 サイズ ボタン 内の ポイント 
を 指定す る。 

rectPtr で 示した レ クタ ン グルレ コー ドは、 ウィン ドウの サイ ズの 下限/上限 
を 意味す る。 疑似 ポインタ も 可。 左上を 示す ポイントが ウィンドウの 最小の 縦 
横 サイズを 意味し、 右下を 示す ポイ ントが 最大の 縦横 サイズを 意味す る。 
再配置が 発生す る。 

C の 関数 ►  LPoint  WMGrow(Window  *winPtr  ,LPoint  pt  ,Rect  れ ectPtr) ; 
返り 値は、 サイ ズを 意味す るポイ ント またはり ザル ト コード。 


$A205 

WMDrag 

引 数 ► 

long 

winPtr 

; ウインド ウレ コー ドへの ポイ ンタ 

long 

pt 

; アニメーション 開始 ポイント （グローバル 

座標） 

long 

rectPtr 

; 移動 制限を 示す レク タング ルレ コードへの 
ポインタ 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

機 能 ►  マウスの 左 ボタンが 抑され ている 間、 マウスの 動きに あわせて winP む： で 指定 
した ウィンドウの 輪郭を 移動させる。 左 ボタンが 離された 時点で、 実際に ウィ 
ン ドウを 移動 させて 終了す る。 

通常、 pt としては マウスが 押された 座標、 つまり、 ドラッグ リージョン 内の ポ 
イ ントを 指定す る。 

rectPtr で 示した レク タング ルレ コードは、 ウィン ドウの 移動 可能な 領域を 意 
味す る （グローバル 座標）。 疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ►  int  WMDrag (Window  *winPtr ,  LPoint  pt,  Rect  *rectPtr) ; 
返り 値は リ ザル トコー ド。 
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$A206 

WMZoom 

引 数- 

long 

winPtr 

; ウイ ン ドウ レコー ドへの ポイ ンタ 

word 

partCode 

; ノ ベ* ー  トコ ー ド 

word 

active 

; アクティブ フラグ 

返り 値 ► 

DO.L 

リ ザル ト コード 

機能 ►  winPtr で 指定した ウィンドウを、 pa れ Code じ 従って ズーム イン/アウトす 
る。 partCode は ズーム ボックス 関係 （8,7) のみ 有効。 

active と して- 1 を 指定す ると、 ウィン ドウを アクティブに してから ズー ムイ 
ン / アウトを 行う。 

再配置が 発生す る。 

C の 関数 ►  int  WMZoom (Window  *winPtr , int  partCode , BOOLEAN  active); 
返り 値は リザ ル トコ ー ド。 


$A207  WMShow 


引 数 ► long  winPtr  ; ウインドウ レコー ドへの ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機能 ►  WinPtr で 指定した ウィンドウを 可視 じする。 

再配置が 発生す る。 

C の 関数 ►  int  WAIShowCWindow  *winPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A208  WMHide 


引 数 ► long  winPtr  ; ウィンドウ レコードへの ポインタ 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  WinPtr で 指定した ウィンドウを 不可視に する。 

再配置が 発生す る。 

C  の 関数 ►  int  WMHide  (Window  *winPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A209  WMShowHide 


引 数 ►  long  winPtr  ; ウインドウ レコードへの ポインタ 

word  vFla 居  ； 可視 フラグ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  WinPtr で 指定した ウィンドウを、 vFlag が 0 のとき 不可視に、 -1 のとき 可 
ネ見 じする。 


ウインド ウマン 


343 


ウインド ウマン 


再配置が 発生す る。 

C の 関数 ►  int  WMShowffide (Window  *winPtr,  BOOLEAN  vFlag) ; 
返り 値は リ ザル トコ ー ド。 


$A20A  WMCheckBox 


引 数*^ long 

winPtr 

; ウインド ウレ コー ドへの ポイ ンタ 

long 

pt 

； マウスの クリッ ク 座標 （グローバル 座標） 

word 

partCode 

; ノ'? — トコ — ド 

返り 値 ►  D0.L 

結果 

0 

ウィン ドウ アイテム 外で マウスが 離された 

-1 

ウィン ドウ アイテム 内で マウスが 離された 

other 

リザルト コ ー ド 

機 能 ►  winPtr で 指定 さ れた ウィン ドウ 内の partCode で 指定 された ウィン ドウ アイ 
テムに ついて、 マウスの 左 ボタンが 離される まで 待ち、 離された ポイント カづ肯 
定 した ウィン ドウ アイテム 内で あるか どうかを 調べる。 マウス カーソルが ウィ 
ン ドウ アイテム 上に ある 間 は反較 表示す る。 

通常、 pt としては マウスの 左 ボタンが 押された 座標、 つま リ、 ウィンドウ アイ 
テム 内の ポイント を キ旨定 する。 

再配置が 発生す る。 

C の 関数 ►  int  WMCheckBox ( W indo w  *winPtr  ,LPoint  pt ,  int  DaxtCode) ; 
返り 値は 結果を 意味す る 数備。 


$A20B 

WMCheckCBox 

引 数- 

Ion 呂 

winPtr 

; ウイ ン ドウ レコー ドへの ポインタ 

long 

pt 

; マウスの クリッ ク 座標 （グローバル 座標） 

返り 値 

D0.L 

結果 

0 

クロー ズ ボタン 外で マウスが 離された 

-1 

クローズ ボタン 1 勺で マウスが 離された 

other 

リ ザル トコ ー ド 

機 甚^ ►  winPtr で 指定され た ウィンドウの クローズ ボックス じついて、 マウスの 左ボ 
タンが 離される まで 待ち、 離された ポ イン トカづ t 定 した クローズ ボタン 巧で あ 
るか どう かを 調べる。 マウス々ー ソ ルが ク ローズ ボタ ン上 にある 間は 反転 表示 
する。 

通常、 pt としては マウスの 左 ボタンが 押された 座標、 つまり、 クローズ ボタン 
内の ポイント を 指定す る。 

再配置が 発生す る。 

C の 関数 ►  int  WMCheckCBox (]fJindow  *winPtr ,  LPoint  pt) ; 

返リ 値は 結果を 意味す る 数値。 
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$A20C  WMDrawGBox 


引 数 ► long  winPtr  ; ウィンドウ レコー ドへの ポインタ 

返り 値 D0.L  リザルト コード 

機 能 ►  WinPtr で 指定した ウィンドウの サイズ ボタンを 描画す る。 

再配置が 発生す る。 

C の 関数 ►  int  WMDrawGBox ( W indo w  *winPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A20D  WMUpdate 


引 数 ►  long  winPtr  ; ウィンドウ レコードへの ポインタ 

返り 値 ►  D0.L  リ ザル トコー ド 

機 能 ►  WinPtr で 指定した ウィンドウの アップ デー ト化理 を觸始 する。 
再配置が 発生す る。 

C の 関数 ►  int  WAIUpdate(Window  *winPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A20E  WMUpdtOver 


引 数 ► long  winPtr  ; ウインドウ レコー ドへの ポインタ 

返り 値*-  D0.L  リザ ル トコー ド 

機 能 ►  WinPtr で 指定した ウィンドウの アップデート 化理を 終了す る。 
再配置が 発生す る。 

C の 関数 ►  int  WMUpdtOverCWindow  *winPtr) ; 

返り 値は り ザル トコ ー ド。 


$A20F  WMActive 


引数- なし 

返り 値 ►  A0.L  アクティブ ウィン ドウの ウィ ン ドウ レコー ドへの ポインタ 

機 能 ►  アクティブ ウィンドウの ウィンドウ レコードへの ポインタを 返す。 

C の 関数 ►  Window  *  WMActi ve ( vo id ) ; 

返り 値は ウイン ドウ レコー ドへの ポインタ。 


$A218  WMAddRect 


引 数 ►  long  rectPtr  ; レク タング ル レコー ドへの ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 
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機 能 ►  カレント ウィン ドウの アップデート リージョンに、 rectPtr で 指定した レ クタ 
ン グルを 加える。 この コー ルを 呼ぶ のは $A20D  WMUpdate の 前で なければ な 
ら ない。 

レク タン グルは グローバル 座標で 指定す る こと。 

再配置が 発生す る。 

C の 関数 ►  int  WMAddRect (Re ct  *rectPtr) ; 

返り 値は リ ザル トコー ド。 


$A219  WMAddRgn 


引 数 ► long  rgnHdl  ; リー ジョン レコー ドへの ハンドル 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機能 ►  カレント ウイン ドウの アップ デー ト リー ジョン じ、 rgnHdl で 指定した リ ージョ 
ンを 加える。 この コールを 呼ぶ のは $A20D  WMUpdate の 前で なければ ならな 

い。 

リージョンは グロ ー バル 座標で 指定す る こと。 

再配置が 発生す る。 

C の 関数 ►  int  WMA ddRg •打 （R% ion  **rgnHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A21A  WMSubRect 


引 数 ► 1011 呂  rectPtr  ; レク タング ルレ コードへの ポインタ 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  々レント ウィン ドウの アップ デ ー トリー ジョ ン から rectPtr で 指定した レク 
タング ルを 除く。 この コー ルを 呼ぶ のは $A20D  WMUpdate の 前で なければ な 
ら ない。 

レク タング ルは グローバル 座標で 指定す る こと。 

再配置が 発生す る。 

C の 関数 ►  int  WMS 11  bRect ( Re c t  *rectPtr) ; 

返り 値は リ ザル トコー ド。 


$A21B  WMSubRgn 


引 数 ►  long  rgnHdl  ; リージョン レコードへの ハンドル 

返り 値 ►  DO.L  リザ ル トコー ド 

機 自長 ►  カレント ウイン ドウの アップデート リージョンから rgnHdl で 指定した リ ージョ 
ンを 除く。 この コー ルを 呼ぶ のは $A20D  WMUpdate の 前で なければ ならない。 
リージ ョ ンは グローバル 座標で 指定す る こと。 
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再 配厦が 発生す る。 

C の 関数 ►  int  WMSiib_RgTKR%ion  **rgnHdl) ; 
返り 値は リ ザル トコー ド。 


$A21C  WMGScriDtSet 


引 数 ►  long  scriptHdl  ; スクリプトへの ハンドル 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  カレント ウィンドウに、 scriptHdl で 指定した ウィンドウ スクリプトを 設定 
する。 

C の 関数 ►  int  WMGScriptSet (GScr ipt  **scriptHdl) ; 

返り 値は リザ ル トコ ー ド。 


$A21D  WMGScriptGet 


引 数 なし 

返り 値 ►  A0.L  ウインドウ スクリプトへの ハンドル 

機 能 ►  々レント ウイン ドウに 設定され ている ウイン ドウス ク リプト への ハン ドルを 返す。 


$A21E  WMTitleSet 


引 数 ►  long  winPtr  ; ウインドウ レコードへの ポインタ 

long  strLPtr  ;LASCII 型の 文字列への ポインタ 

返り 値 ►  D0.L  リザルト コード 

機能 ►  WinPtr で 指を した ウィンドウの タイ トルを StrLPtr で 指定し た 文字列 じ 変 
更 し、 ウィンドウを 揃き 直す。 疑似 ポインタ も 可。 

再配置が 発生す る。 

C  の 関数 ►  int  WMTitleSet  (Window  *winPtr ,  const  _LASCII  strLPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A21F  WMTitleGet 


引 数 ►  long  winPtr  ; ウィンドウ レコー ドへの ポインタ 

long  StrLPtr  ;LASCII 型の 文字列 バッファへの ポインタ 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  WinPtr で 指定した ウィンドウの タイトルを、 StrLPtr で 指定した 文字列 バッ 
ファ に 返す。 

C の 関数 ►  int  WMTitieGet (Window  幸 winPtr,  _LASCII  strLPtr) ; 

結果は、 LASCII 型の ポインタ StrLPtr で 示される バッファに 格納され る。 
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返り 値は リ ザル トコ ー ド。 


$A220  WMTIDSet 


引 数 ► long  taskID  ; タスク ID 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能  >  カレント ウインドウの タスク ID を taskID じ 変更す る。 
C の 関数 ►  int  WMTIDSet ( long  taskID) ; 

返り 値は リ ザル トコ ー ド。 


$A221  WMTIDGet 


引 数- なし 

返り 値 ►  D0.L  タスク ID 

AO .  L  ウインドウ レコード への ポインタ 

機 能 ►  カレント ウインドウの タスク ID を 返す。 

C の 関数 ►  int  WMTIDGet  (void) ; 

返り 値は タスク ID。 


$A222  WMPinRect  1 3.G 


引 数 ► long  rectPtr  ; レク タング ル レコー ドへの ポインタ 

long  pt  ; ホ イン ト 

返り 値 ►  D0.L  pt に 最も 近い ポイント 

機能 ►  pt が rectPtr で 示さ れた 矩形 領域の 巧侧 にあれば pt そのものを、 外側に あ 
れば 矩形 領域の なかで pt に嚴も 近い ポイント を 返す。 

C の 関数 ►  LPoint  WMPinRect (Rect  *rectPtr ,  LPoint  pt) ; 

返リ 値は ポイント。 


$A223  WMCalcUpdt  1~3^ 


引 数 ►  long  rgnHdl  ; リージョン レコー ドへの ハンドル 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  々レント ウィン ドウの アップデート リージ ョ ンに rgnHdl で 指定した リージ ョ 
ンを 加える。 ウィンドウの 外形 も 考慮され る。 この コー ルを 呼ぶ のは $A20D 
WMUpdate の 前で なければ ならない。 

リージ ョ ンは グローバル 座標で 指定す る こと。 

再配置が 発生す る。 
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C の 関数 ►  int  WMCalcUpdt (Region  幸 本 rgnHdl) ; 
返り 値は リ ザル トコ ー ド。 


$A224  WMGetDTGS 


引 数- なし 

返り 値 ►  AO.L  グローバル 変数 DeskTopGScript の アドレス 

機 能 ►  グロー バル 変数 DeskTopGScript の アドレスを 返す。 この 変数には、 背景の 
絵を 描画す るスク リプト への ハン ドルが 入って いる。 

C  の 関数 ►  GScript  ***  WMGetDTGS  (void) ; 

返り 値は DeskTopGScript の アドレス。 


$A225  WMDragRgn 


引 数- 


返り 値 ► 
機肯卜 


long 

rgnHdl 

; リー ジョン レコードの ハンドル 

long 

pt 

; ポイント （グローバル 座標） 

long 

IRectPtr 

; レク タング ル レコー ドへの ポインタ 
バル 座標） 

(グロー 

long 

sRectPtr 

; レク タング ル レコー ドへの ポインタ 
バル 座標） 

(グロー 

word 

axis 

； 移動 制限 フラグ 

bitO 

X 方向に 0: 移動 不可 

1 : 移動 可 

bitl 

y 方向に 0: 移動 不可 

1: 移動 可 

long  procPtr  ; ユーザ 定義の 闊 数のア ドレス 

D0.L  pt からの 移動 畳を 示す ポイ ント / リザルト コード 

マウスの 左 ボタ ンが 押されて いる 間、 マウスの 動きに あわせて rgnHdl です 育定 

した リージ ョ ンの 輪郭を 移動させる。 左 ボタンが 離された 時点で 終了す る。 

通常、 pt としては マウスが 押された 座標を 指定す る。 

IRectPtr で 示した レク タン グルの 範閒 を 超える と リージ ョ ンの 輪郭は 移動し 
な くな り、 sRectPtr で 示した レク タン グルの 範閣 を 超える と 輪郭は 消える。 
procPtr には、 マウスの 左 ボタンが 押されて いる 間、 繰り返し 実行したい 関数 
の アドレスを お定 する。 不要な 場合は 0 を 指定す る。 脚 数には、 D6 レジスタ 
で pt からの 移動 强を 示す ポイントが 渡される。 全 レジスタを 保な する 必要が 
ある。 


再配置が 発生す る。 

C  の 関数 ►  LPoint  WMDragRgn  (Region  **rgnHdl,  LPoint  pt, 
Rect  *lRectPtr,  Rect  *sRectPtr,  int  axis , 
void  (幸 procPtr) 0 ) ; 
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返り 値は pt からの 移動 量を 意味す る ポイント。 
負の 値の 場合は エラー。 


$A22C  WMOptionGet 


引 数 なし 

返り 値 ►  D0.L  ウィン ドウ オプション （下位 ヮー ドの み 意味を 持つ） 

機 能 ►  カレント ウインドウの ウインドウ オプション （wOption) を 返す。 
C  の 関数 ►  int  WMOptionGet  (void) ; 

返り 値は ウィン ドウ オプション。 


$A22D  WMOptionSet 


引 数 ►  word  W 雌 t  ; ウインドウ オプション 

返り 値 >  なし 

機 能 ►  々レント ウインドウの ウインドウ オプション （wOption) を 設定す る。 
C の 関数 ►  void  WMOptionSet ( int  wOpt) ; 

返り 値は ない。 


$A22E  WMPtInGBox 


引 

数- 

long 

pt 

; ローカル 座標を 意味す る ポイント 

返り 値 > 

D0.L 

=  0 

サイ ズ ボタ ン のなかに はない 

丰り 

サイ ズ ボタ ン のなかに ある 

機 

能- 

pt で 指定した ポイ ント が々 レント ウィン ドウの サイズ ボタンの 中に あるか どう 

かを 調べる。 

C の 関数 ►  BOOLEAN  WAdPtInGBoxCLPoint  pt) ; 
返り 値は 結果を 意睐 する 数値。 


$A22F  WHOpen 


L3.0 


引 数 ► long 
long 
long 
long 
long 
long 
long 


pWinPtr 

winPtr 

boundRectPtr 

titleLStrPtr 

visible 

wDefID 

wOption 


親ウ インド ウレ コー ドへの ポイ ンタ 
ウインドウ レコー ドへの ポインタ 
レク タン グル レコード への ポイ ンタ 
LASCII 型の 文字列への ポイ ンタ 
可視 フラグ 
リソース ‘WDEF' の の 
ウイン ドウ オプション 
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long 

behindWinPtr 

long 

cBttn 

long 

taskID 

返り 値 ►  D0.L 

=  0 

エ ラー 

丰り 

ウ  イン 

bitO 

ス クロ  ー ルバー 

bitl 

クリップ 

bit2 

ドライ ブ 表示 

bits 

サイ ズ ボタン 

; ウィンド ウレ コー ドへの ポイ ンタ 
; クローズ ボタン フラグ 
; タスク ID 番号 

レコ ー ドへの ポイ ンタ 


機 能 ►  pWinPtr で 寸育定 した ウィン ドウを 親 ウィン ドウと する ウィン ドウを 開く。 pWin 
Ptr として 0 を 指定す ると、 ルート ウインドウ （ニ デスク ト ップ 画面） 上に 


開く。 

基本的に $A1F9  WMOpen と 同様 だが、 wDef  ID を 16 倍す る 必要がない こと 
と、 wOption を 別に 指を する 必要が ある こと、 そして 返り 値の 戻し 方が 異なる 
点に 注意。 

再 配 霞が 発生す る。 

C の 関数 ►  Window  * WHOpen (HWindow  *pWiiiPtr ,  Window  *winPtr , 


Rect  *boundRectPtr ,  LASCII  *titleLStrPtr ,  int  visible , 


int  wDefID,  int  wOption,  Window  *behindWinPtr , 
int  cBttn,  long  taskID) ; 

返り 値は ウイン ドウ レコー ドへの ポイ ンタ。 

エラー が 発生し た 場合、 NULL が 返る。 


$A230  WHGet 


[3 •日 


引数- なし 

返り 値 ►  DO  .L  ル ー ト ウイ ン ドウの ウイ ン ドウ レコ ー ドへの ポインタ 

A0.L  ルー ト ウイ ン ドウの ウイ ンド ウレ コー ドへの ポイ ンタ 
機 能 ►  ルー トウ イン ドウの ウ インド ウレ コー ドへの ポイ ンタを 返す。 

C の 関数 ►  HWindow  *  WHGet  (void) ; 

返り 値は ウイン ドウ レコー ドへの ポイ ンタ。 


$A231  WM0pen2 


Cao 


引 数 ► long 
long 
long 
long 
long 
long 


winPtr 

bound 托 ectPtr 
title し StrPtr 
visible 
wDefID 
wOption 


ウィンド ウレ コー ドへの ポインタ 
レ クタ ン グルレ コー ドへの ポイ ンタ 
LASCII 型の 义字 列への ポイ ンタ 
可視 フラグ 

リ ソース fWDEF， の ID 
ウイン ドウ オプション 
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bitO 

スク ロー ルバー 

bitl 

クリ ップ 

bit2 

ドライブ 表示 

bits 

サイズ ボタン 

ウィ ンド ウレ コー ドへの ポイ ンタ 
クローズ ボタン フラグ 
タスク ID 番号 


long  behindWinPtr 
long  cBttn 

long  taskID 

返り 値 ►  DO.L  =0  エラー 

丰り  ウインドウ レコー ドへの ポイ ンタ 

機能- ウィン ドウを 開く。 

基本的に $A1F9  WM 邸 en と 同様 だが、 wDef  ID を 16 倍す る 必要がない ことと、 
wOption を 別に 指定す る必 嬰が あ る こと、 そして 返り 値の 戻 し 方が 異なる 点じ 
を 意。 

再配置が 発生す る。 

C の 関数 ►  Window  WMOpeii2( Window  *wiiiPtr ,  Rect  *boundsRectPtr ， 
LASCII  *titleLStrPtr ,  int  visible ,  int  wDefID, 
int  wOption,  Window  ♦behindWinPtr , 
int  cBttn,  long  taskID) ; 

返り 値は ウイン ドウ レコー ドへの ポイ ンタ。 

エラーが 発生した 場合 NULL が 返る。 


$A232 


WMMaxgineGet 


1 3.0 


rectPtr 


レク タン グル レコ ー ドへの ポインタ 


引 数 ► long 
返り 値 ►  なし 

機 能 ►  rectPtr で 指定した レク タング ル レコー ドに、 ズーム 時の ウインドウの デ イス 
プレイ レク タン グルに 対する 上下 左 も— の マージン を 返す。 レク タン グルの lef  t , 
top,  right ,  bo な om が 左上 右下の マージンを 意味す る。 

C の 関数 ►  void  WMMargineGet (Rect  *rectPtr) ; 

結果は、 Rect 型の 変数 rectPtr に 格納され る。 


$A233 


WMMargineSet 


I  3.0 


引 数 
返り 値 
機能 ► 


rectPtr 


レ クタ ン グルレ コー ドへの ポイ ンタ 


long 
なし 

ウィン ドウ ズーム 時の、 ディ ス プレイ レク タング ルに 対する ウィン ドウの 上下 
左右の マー ジンを rectPtr で 示す レク タン グルで 指定す る。 レク タン グルの 
left ,  top,  right ,  botto 皿が 左上を 下の マー ジンを 意味す る。 
マージンの 値は 各方 向と も 〇〜 128。 

C の 関数 ►  void  WMMargineSet  (Rect  *rectPtr) ; 


ウインド ミン 
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返り 値は ない。 


ウインド ウマン 


$A235  WMMove2  で 


引数 ► long 

winPtr 

； ウインドウ レコー ドへの ポインタ 

long 

pt 

; ウィン ドウの 位置を 示す ポイント （グロ 
バル 座標） 

word 

ELCtlV 色 

； アクティブ フラグ 

返り 値 ►  D0.L 

リ ザル トコ ー ド 

機 能 winPtr で、 指定した ウィンドウを pt で 指定した 位置に 移動す る。 その 際、 active 
力、 • -1 なら ウィンドウを アクティブに してから 移動させる。 

指定した ウィン ドウが 子 ウィン ドウを 持つ 場合で も、 子 ウィン ドウは 移動し な 

い。 

再配置が 発生す る。 

C の 関数 ►  int  WMMove2 ( W indo w  *winPtr ,  LPoint  pt ,  int  active) ; 

返り 値は リ ザル トコ ー ド。 
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サブ ウインド ウマン 


#include  〈WINDOW. H> 


$A227 


WSOpen 


引 数 ► long  sWinPtr 

long  rgnHdl 


long  prio 


サブ ウ インド ウレ コー ドへの ポイ ンタ 
アウト サイ ドリー ジョンと なる リージ ョ 

への ハン ドル 

プライオリティ 値 


返り 値 ► 


D0.L  リザ ル トコー ド 

A0.L  サブ ウイ ン ドウ レコー ドの ア ドレス 

m 能 >  新しい サブ ウィンドウを 開く。 

sWinPtr が 0 の 場合、 サブ ウインドウ マネージャが ヒープ 上に 作成す る。 
再配置が 発生す る。 

C の 関数 ►  Subwin  *  WSOpen  (Subwin  *sWinPtr ,  Region  **rgnHdl , unsigned 
long  prio) ; 

返り 値は サブ ウイン ドウ レコー ドへの ポイ ン タ。 

エラーの 場合は NULL が 返る。 


$A228 


WSClose 


引 数 ►  long  sWinPtr  ; サブ ウィンドウ レコードへの ポインタ 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機能 ►  sWinPtr で 指定した サブ ウィンドウを 閉じ、 サブ ウィンドウ リストから 削除す 
る。 

サブ ウィンドウ レコードを ヒープ 上 W 外に 作成 してい た 場合に 使用す る。 
再配置が 発生す る。 

C の 関数 ►  int  WS 口 ose(Siibwin  *sWinPtr) ; 

返り 値は リザ ル トコ ー ド。 


$A229 


WSDispose 


弓 1 数 ►  long  sWinPtr  ; サブ ウインドウ レコー ドへの ポインタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  sWinPtr で 指ました サブ ウィンドウを 剛 じ、 サブ ウィンドウ リストから 削除し 
た あと、 サブ ウィン ドウ レコードと して 確保され ていた ブロックを 廃棄す る。 
サブ ウ ィンド ウレ コー ドを ヒープ 上に 作成して いた 場合に 使用す る。 


サフ ウインドウ マン 
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再配置が 発生す る。 

C の 関数 ►  int  WSDispose ( Subwin  *sWinPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A22A  WSEnlist 


引 数 ►  long  sWinPtr  ; サブ ウィンドウ レコードへの ポインタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  sWinPtr で 指定した サブ ウィンドウを サブ ウィンドウ リストに 加える。 

C の 関数 ►  int  WSEnlist (Subvi in  *sWinPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A22B  WSDelist 


引 数 ►  long  sWinPtr  ; サブ ウィンドウ レコードへの ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  sWinPtr で 指定した サブ ウィン ドウを サブ ウィン ドウ リス ト から 削除す る。 
C  の 関数 ►  int  WSDelist  ( Sub  win  *sWinPtr) ; 

返り 値は リ ザル トコ ー ド。 


メニュー 7 ン 


乂 ニュー 7 ン 


#include  <MENU.H> 


$A266 

MNInit 

引 数- 

なし 

返り 値*^ 

なし 

機 能- 

メニュ 

ー マンを 初期化す る。 

C の 関数 ► 

void  MNI 打が (void) ; 

返り 値は ない。 

$A267 

MNRefer 

引 数- 

word 

皿  emilD 

; リ ソース ‘MENU’ の ID 

返り 値 

D0.L 

リ ザル トコー ド 

A0.L 

メニュ ー レコ _ ド への ハン ドル 

機 負^ ■- リソース タイプ‘ MENU’、 ID 皿 enuID として 定義され ている メ ニュー テン プ レー 
卜の 内容に f 走って メニューを 定義す る。 

再配置が 発生す る。 

C  の 関数 ►  Menu  *  *  MNRefer  ( short  menuID) ; 

返り 値は メニュ ー レコ ー ド への ハンドル。 


$A268 

MNSelect 

引 数- 

long 

menuHdl 

; メニユ ー レコ ー ドへの ハン ドル 

long 

pt 

; 表示を 關始 する ポイント （グローバル 座標 
系） 

返り 値 

DO.L 

=  0 

牛。 

何も 選択され なかった 

下位 ワード： メ ニュー アイテム 番号 （1 〜） 

上位 ワード： 階層 メニュー ID/ リザ ル トコード （負の 値） 

機能 ►  pt です 胃定 した ポイ ント から menuHdl で 指定した メ ニュー レコ ー ドの 内容に 
f 追って メニューを 描画し、 そのうえで マウスのを ボタンが 離された （選択され 
た） メニュー アイテムの 番号を 返す。 

通常、 pt じは マウスの 右 ボタ ンが 押された ポイント を 指定す る。 

階層 メニ ューが 選択され た 場合、 返り 値の 上位 ヮー ドは 階層 メ ニュー テン プ レー 
卜のリ ソース ID を 意味す る。 階層 メニ ュー 表示の 0.3 秒の タイム ラグ 中に マウ 
スの ボタン が 離さ れた 場合、 親 アイテムの 番号が 返される。 
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再配置が 発生す る。 

C の 関数 ►  int  MNSelect (Menu  **menuHdl,  LPoint  pt) ; 

返り 値は 下位 ワー ドが メニュー アイテムの 番号、 上位 ワー ドが 階層 メニュ ーID。 
負の 値の 場合は リ ザル トコ ー ド。 


$A269 

MNConvert 

引 数 

long 

皿 enuHdl 

; メニユ ー レコ ー ド への ハン ドル 

long 

strZPtr 

; メ ニュー 定義 文字列 (ASCIIZ) への ポイ 

ンタ 

word 

ID 

； メ ニュー 定義 1 钩 数の ID 

返り 値 

DO.L 

リザルト コ ー ド 

AO.L 

メ ニユー レコ ー 

ドへの ハン ドル 

機 能- strZPtr で 指定した 义字 列に よって、 メ ニュー レコー ドを 作成す る。 

皿 enuHdl 力 《 0 の 場合、 メニュー マンが ヒープ 上に 作成す る。 

メニュー 定義 义字 列とは、 基本的 じメ ニュー アイテムを 1 つず つ カンマ で 区切 っ 
たもの。 特殊 文字を 利用す る ことじ よって シヨー ト 々ッ トや チェック マー クの指 


定を 行う こ 

とがで きる。 

特殊 文字 

内  容 

一 

ショー ト カット 文字の ネ 旨を。 かの 1 文字が シ ョート カット 义字 となる 

一 

この 文 宇で 始まる アイテムは イ ン アクティブ となる 

! 

チェック マークを つける 

再配置が 発生す る。 


C の 関数 ►  Menu  幸* MiVCo 打 ve バ （Menu  **menuHdl , const  char  *strZPtr , 
int  ID); 

返り 値は、 メニュー レコードへの ハン ドル または リザ ル トコー ド。 


$A26A 

MNSelect2 

1  2.0 

引 数- 

long 

皿 enuHdl 

9 

メニュー レコ _ ドへの ハン ドル 

long 

pt 

表示を 開始す る ポイント （グロ 
系） 

_ バル 座標 

long 

rectPtr 

1 

レク タング ルレ コードへの ポインタ （グロー 
バル 座標系） 

返り 値*^ 

DO.L 

=  0 

牛。 

何も 選が されなかった 

ド 位 ワード： メ ニュー アイテム 番号 （1 〜） 
上位 ワード： 階層 メニュ ーID/ リザ ル トコー 

ド （負の 値） 

機 能 ►  pt で 指定した ポイントから、 皿 emiHdl で 指定した メニュー レコードの 内容に 
従って メニューを 描画し、 そのうえで マウスの 右 ボタンが 離された （遵択 され 
た） メ ニュー アイテムのを 号を 返す。 


メニユ —マン 
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C の 関数 • 


通常、 pt じは マウスの 右 ボタ ンが 押された ポイント を 指定す る。 

メニューは、 rectPtr で 指定した 範囲 内に 表示され る。 

階層 メニューが 選が された 場合、 返り 値の 上位 ワー ドは 階層 メニ ュー テン プ レー 
卜のリ ソース ID を 意味す る。 階層 メニュー 表示の 0.3 秒の タイム ラグ 中に マウ 
スの ボタン が 離さ れた 場合、 親 アイテムの 番号が 返される。 

再配置が 発生す る。 

int  MNSelect2 (Menu  ** 虹 emiHdl,  LPoint  pt, 托 ect  *rectPtr) ; 
返り 値は、 下位 ワードが メニュー アイテムの 番号、 上位 ワー ドが 階層 メニュー 
の。 

負の 値の 場合は リ ザル トコ ー ド。 


$A26B 


MNConvert2 


I  3.0 


引 数 ► long  皿  enuHdl 

long  strZPtr 


返り 値 I 


機能 ► 


; メニュー レコー ドへの ハン ドル 

； メニュー 定義 文字列 (ASCIIZ) への ポイ 
ンタ 

； メニュー 定義 闕 数の ID 


word  ID  ;  メ  ニ 

D0.L  リ ザル トコ ー ド 

A0 . L  メニユ ー レコー ドへの ハン ドル 

StrZPtr で 指定した 文字列に よって、 メニュー レコードを 作成す る。 
menuHdl が 0 の 場合、 メ ニュー マンが ヒープ 上に 作成す る。 

メニュー 定義 文字列とは、 基本的に メ ニュー アイテムを 1 つず つ カンマで 区切 っ 
たもの。 特殊 文字を 利用す る ことによって、 ショートカット や チェック マークの 
指定を 行う ことができる。 


特珠义 字 

内容 

一 

ショー ト カット 文字の 指定。 ホの 1 文字が シ ョート カット 文字と なる 

一 

この 文字で 始まる アイテムは イ ン アクティブ となる 

1 

チュッ ク マークを つける 

1 

かの 1 文字を チュッ クマ ー クフ ラグの 欄に 格納す る 
エスケープ キャラクタ も 使用可能 （階層 メニュー ID 指定 用） 

tl 

読み 飛ばされ るので 意味を 持たない 

\ 

エス ケープ キャラクタ 

\~  ~ 

\!  ! 

\|  1 

\  11  II 

\\  \ 

\，  ， 

\〇〇〇  00 〇 は 8 進数 3 が じ 1内 

\x 址  hh は 16 進数 内 

巧 配置が 発生す る。 

C の 関数 ►  Menu  *  *  MJV  Con  vert  2  (Menu  幸*  皿  enuHdl , char  *strZPtr,  short  ID); 
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返り 値は メニュー レコ ー ドへの ハン ドル。 
エラーが 発生した 場合、 NULL が 返る。 


$A26C  MNSelectS 


巧 □ 


引 数- 

long 

menuHdl 

; メ ニユー レコー ドへの ハン ドル 

long 

皿 ousePt 

; マウスの 位置を 意味す る ポイント （グ ロー 
バ ル 座標系） 

long 

menuPt 

； メニューの 表示 開始 位置を 意味す るポ イン 
卜 （グロー バル 座標系） 

long 

ite 皿 

; 初期 アイテム 番号 

long 

rectPtr 

; レク タング ル レコー ドへの ポインタ （グロー 
バル 座標系） 

返り 値*^ 

DO.L 

=  0 

丰り 

何も 選択され なかった 

下位 ヮー ド： メ ニュー アイテム 番号 （1 〜） 

上位 ヮー ド： 階層 メニュ ーID/ リザルト コード （負の 値） 
機 能 ► 皿 emiHdl で 指定した メニュー レコー ドの 内容に 従って メニ ューを 描画し、 その 
う えで マウスの 右 ボタンが 離された （選択され た） メニュー アイテムの 番号を 
返す。 メニューを 描画す る 際、 ite 皿で 指定した アイテムが 皿 eniiPt から 表示 
される ように 表示 位置を 調整す る。 moiisePt じは、 ボタンが 押された ときの マ 
ウスの 座標を 別途 指を する。 

メ ニュー は、 rectPtr で 指定 した 範圃 内に 表示され る。 

階層 メニ ューが 選が さ れた 場合、 返り 値の 上位 ヮード は 階層 メ ニュー テン プ レー 
卜のリ ソース の を 意味す る。 階層 メニュー 表示の 0.3 秒の タイム ラグ 中に マウ 
スの ボタン が 離さ れた 場合、 親 アイテムの 番号が 返される。 

ただし、 システム じ 標準で 付属す る メニューを 義閱 数は、 この コー ルに 完全に 
は 対応して いない。 再配置が 発生す る。 

C の 関数 ►  int  MNSelectS  (Menu  ** 虹 emiHdl,  LPoint  mousePt , 

LPoint  皿 emiPt,  short  ♦item,  Rect  れ ectPtr) ; 

返り 値は 下位 ヮー ドが メニ ュー アイテムの 番号、 上位 ヮー ドが 階層 メニュ ーID。 
負の 値の 場合は リ ザル トコ ー ド。 
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コン h  ロール マン 


#include  <CONTROL.H> 


$A289  CMOpen 


引 

数 

long 

winPtr 

ウインドウ レコー ドへの ポイ ンタ 

long 

boundsRectPtr 

レ クタ ン グルレ コー ドへの ポイ ンタ 

long 

titleLStrPtr 

タイ トルを 示す LASCII 型の 文字列への ポ 

インタ 

word 

visiDle 

可ネ見 フラグ 

word 

V る丄 ue 

コント ロールの 初期値 

word 

min 

コント ロ ー ルの 最小値 

word 

max 

コント ロールの 最大値 

word 

cDefID 

リ ソース 'CDEF’ の IDX16 

long 

user 

ユーザ ワークの 初期値 

返り 値 

DO.L 

リ ザル トコ ー ド 

AO.L 

コント ロ ー ル レコ ー ド への ノ 、ンド ノレ 

機 

能- 

winPtr で 指定した ウィン ドウ 中に 新しい コント ロー ルを 作成す る。 

boundsRectPtr は、 コント ロ ー ルの 存在す る 領域を 指定す るレク タング ルレ 
コードへの ポインタ （疑似 ポインタ 可）。 ローカル 座標で 指定す る。 
titleLStrPtr は コント ロールの タイ トルを 指定す る LASCII 型の 文字列 だ 
が、 コントロールの 種類に よっては 無視され る （疑似 ポインタ 可）。 
visible として- 1 を 指定す ると 可視の コントロール、 0 を 指定す ると 不可視 
の コント ロールと なる。 ただし、 $A28E  CMDraw,  $A28F  CMDrawOne など 
を 実 斤す るまでは、 実際には 描画され ない。 

再配置が 発生す る。 

C  の 関数 ►  Control  *  *  CMOpen  (Window  *winPtr,  Rect  *boundsRectPtr , 
const  -LASCII  *titleLStrPtr ,  BOOLEAN  visible, 
int  value,  int  min,  int  max,  int  cDefID,  long  user) ; 

返り 値は コント ロール レコー ドへの ハン ドル。 

エラーの 場合は NULL が 返る。 


$A28A  CMDispose 


引 数 ►  loner  ctrlHdl  ; コント ロ ー ル レコ ー ドへの ハンドル 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  CtrlHdl で 指定した コントロールの レコードを 廃棄し、 コント ロー ルリ スト か 
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ら 外し、 表示を 消す。 

再配置が 発生す る。 

C の 関数 ►  int  CMDispose ( Cont r 〇 1  **ctrlHdl) ; 
返り 値は リ ザル ト コード。 


$A28B  CMKill 


引 数 ► long  winPtr  ; ウインドウ レコー ド への ポインタ 

返り 値 ►  D0.L  リ ザル トコー ド 

機 能 ►  WinPtr で 指定した ウィンドウ 上の コント ロー ルを すべて 廃棄す る。 
再配置が 発生す る。 

C  の 関数 ►  int  CMKill  (Window  *winPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A28C  CMHide 


引 数 ►  long  ctrlHdl  ; コント ロー ルレ コードへの ハンドル 

返り 値 ►  DO.L  リザルト コード 

機能 CtrlHdl で 指定した コント ロールを 不可 ネ 見に する。 表示 も 消す。 
再配置が 発生す る。 

C の 関数 ►  int  CMHide  (Control  **ctrlHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A28D  CMShow 


引 数 ► long  CtrlHdl  ; コント ロー ルレ コードへの ハンドル 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  CtrlHdl で 指定した コント ロー ルを 可視 じする。 再 描画す る。 
再配置が 発生す る。 

C  の 関数 ►  int  CMShow  (Control  **ctrlHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A28 巨  CMDraw 


引 数 ► long  winPtr  ; ウィンドウ レコー ドへの ポインタ 

返り 値*-  DO.L  リ ザル トコ ー ド 

機 能 ►  winPtr で 指定した ウィンドウ 上の コント ロー ル （可視の もの） をす ベて 描画 
する。 

再配置が 発生す る。 
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C の 関数 ►  int  CMDrawCWindow  *winPtr) ; 
返リ 値は リザ ル トコ ー ド。 


$A28F  CMDrawOne 


引 数 ►  long  ctrlHdl  ; コント ロー ル レコー ドへの ハンドル 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 >  CtrlHdl で 指定した コントロール （可 巧の もの） を 描画す る。 

再配置が 発生す る。 

C  の 関数 ►  int  CMDrawOne  (Control  **ctrlHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A290  CMValueSet 


引 数 ► Ion 長  CtrlHdl  ; コントロール レコー ドへの ハンドル 

word  value  ; コント ロールの 値 

返り 値 ►  D0.L  リザルト コード 

機能 ►  CtrlHdl で 指定した コント ロールの 値を value にす る。 変更した 状態が 再 描 
画される。 

再配置が 発生す る。 

C  の 関数 ►  int  CMValueSet  (Control  **ctrlHdl,  int  value) ; 

返り 値は リ ザル トコ ー ド。 


$A291  CMValueGet 


引 数 ► long  CtrlHdl  ; コントロール レコー ドへの ハンドル 

返り 値 ►  D0.L  コント ロールの 値 （下位 ヮー ド） 

/ リザ ル ト コード （ロング ワー ドの 負の 値） 

機能 ►  CtrlHdl で 指定した コント ロールの 値を 返す。 

C の 関数 ►  int  CMValueGet  (Control  **ctrlHdl) ; 

返り 値は リ ザル トコー ド。 


$A292  CMMinSet 


引 

数- 

long 

CtrlHdl 

; コント ロ  ー ル レコ ー ド への ハンドル 

word 

min 

; コント ロー ルの 最小値 

返り 値 ► 

DO.L 

リザ ノレ トコ ー ド 

機 

能- 

CtrlHdl で ネ旨定 した コント ロ 

ー ルの 最小値を min にす る。 変更した が 態が 再 

描画され る。 
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再配置が 発生す る。 

C の 関数 ►  int  CMMinSet (Control  **ctrlHdl, int  min) ; 
返り 値は リ ザル トコ ー ド。 


$A293  CMMinGet 


引 数 ► long  ctrlHdl  ; コント ロー ル レコー ドへの ハンドル 

返り 値 ►  D0.L  コントロールの 最小値 （下位 ワード） 

/リザルト コード （ロング ワー ドの 負の 値） 

機能 ►  CtrlHdl で 指定した コン トロー ルの 横 小 値を 返す。 

C の 関数 ►  int  CMMin Ge t ( C ont r o 1  **ctrlHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A294  CMMaxSet 


引 

数- 

long 

CtrlHdl 

; コント ロールレ コードへの ハンドル 

word 

max 

; コント ロー ルの 最大値 

返り 値 

DO.L 

リ ザル トコ ー ド 

機 

能 

CtrlHdl で 指を した コント ロ 

ー ルの 嚴大 値を max にす る。 変更した が 態が 再 

揣 画される。 

再配置が 発生す る。 

C  の 関数 ►  int  CMMaxSet  (Control  **ctrlHdl,  int  max); 
返り 値は リ ザル トコー ド。 


$A295  CMMaxGet 


引 数 ►  long  CtrlHdl  ; コント ロー ル レコー ドへの ハンドル 

返り 値 ►  D0.L  コントロールの 最大値 （下位 ワード） 

/ リザ ル トコー ド （ロング ワー ドの 負の 値） 

機 能 ►  CtrlHdl で 指を した コント ロールの 嚴大 値を 返す。 

C の 関数 ►  int  CMMaxGet  (Control  **ctrlHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A2% 

CMMove 

引 数- 

long 

CtrlHdl 

; コントロール レコー ドへの ハンドル 

long 

pt 

; コント ロ ー ルを 移動させる ポイント （口 一 
カル 座標） 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 
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機能 > 


機能 >  ctrlHdl でネ 旨を した コント ロールを pt で 指定した ポイント に 移動 させ、 再揣 
幽する。 

再配置が 発生す る。 

C の 関数 ►  int  CMMove (Control  **ctrlHdl,  LPoint  pt) ; 

返り 値は リ ザル トコー ド。 


$A297 


CMSize 


引 

数- 

long 

CtrlHdl 

long 

sizePt 

返り 値 ► 

DO.L 

リ ザル トコード 

機 

能- 

CtrlHdl で ネ旨定 したつ ン 1 

コント ロール レコ'- ドへの ハン ドル 

コント ロ ー ルの サイズ を 示す ポイント 


イズじ 変更す る。 変更した サイズで 再 揃 画する。 

再配置が 発生す る。 

C の 関数 ►  int  CMSize ( Control  **ctrlHdl , LPoint  sizePt) ; 
返り 値は リ ザル トコー ド。 


$A298 


CMShine 


引数 ► long 
word 


返り 値 
機能 


DO.L 


CtrlHdl 

DartCode 


リザ ノレ トコ ー ド 


コント ロール レコ、 
パー トコ ー ド 


ドへの ハン ドル 


?〜9 

コント ロ ー ル 全体 
ューザ 用 

10 

標準 ボタン 

11 

ボタン 

12 〜 19 

ューザ 用 

20 

アッ プ ボタン 

21 

ダウン ボタン 

22 

アッ プ ぺージ 

23 

ダウ ン ページ 

24 

タイトル 

25 〜 128 

ューザ 用 

129 

ドラ ッ グ できる 部分 

130 〜 254 

RESERVED 

255 

イ ン アクティブ 状態 

CtrlHdl で 指定した コント ロールの、 partCode で 指定した 部分を 強調 表示 
する。 0 を 指定した 場合は コント ロー ル 全体が 強調され、 255 を 指を した 場合 
は コント ロール 全体が イ ン アクティブが 態で 表示され る。 

再配置が 発生す る。 

C の 関数 ►  int  CMShine ( C ont r o 1  **ctrlHdl , int  partCode); 

返り 値は リザ ル トコ ー ド。 
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$A299 

CMFind 

引数 

long 

pt 

; ポイント （ロー々 ル 座標） 

long 

winPtr 

; ウィンドウ レコー ドへの ポイ ンタ 

返り 値 

DO.L 

=  0 

該当する コント ロールは ない 

丰り 

パ ー トコ ー ド （下位 ヮ ー ド）/ リザ ノレ トコ ー ド 

AO.L 

コン トロ ー ル レコ ー ド への ハンドル 

機 能 ►  winPtr で 指定した ウィン ドウの なかの pt で 指定した 座標に コント ロールが 
存在す るか どうかを 調べ、 存在した 場合は コント ロール レコードへの ハンドル 
と パート コードを 返す。 

C の 関数 ►  int  CMFmd(LPoint  pt ,  Window  *winPtr ,  Control  ♦**ctrlHdl) ; 
返り 値は パー トコ ー ド。 

Control 型の ポイ ンタ 変数な rlHdl じ、 該当する コン トロールの コント ロー 
ル レコ ー ドへの ハン ドル が 返る。 


$A29A  CMCheck 


引 

数 

long 

CtrlHdl 

; コント ロ ー ル レコ ー ドへの ハン ドル 

long 

pt 

; マウスの クリッ ク 座標 （口ーカル 座標） 

long 

procPtr 

; ユーザ 定義の 関数の ア ドレス 

返り 値 

DO.L 

パー トコー 

ド （下位 ワード）/ リザルト コード 

機 

能- 

ctrlHdl で 指定され た コント ロー ルに ついて、 マウスの 左 ボタンが 離される ま 

で 待ち、 

離された ポイ ントが 指定した コン トロール 内で あるか どうかを 調べる。 

マウス カーソルが コント ロール 上に ある 間は 強調 表示す る。 


通常、 pt としては マウスの 左 ボタンが 押された 座標、 つまり、 コントロール 巧 
の ポイント を 指定す る。 

procPtr には、 マウスの 左 ボタンが 押されて いる 間、 繰り返し 実 斤したい 関数 
のア ドレスを 指定す る。- 1 を 指ました 場合は その コント ロールの デフォルトの 
関数が 使われ、 0 を 指定した 場合は 選が された パートを ハイ ライ ト 表示す るの 
みとなる。 ユーザの 指定した 闕 数には スタックを 利用して じ I 下の 引数が 渡され 


る。 

long 

CtrlHdl 

; コントロール レコードへの ハンドル 

word 

c Opt ion 

; コント ロ  ー ル オプション コ ー ド 

long 

pt 

; 移動 盘を 示す ポイント 

再配置が 発生す る。 

C の 関数 ►  int  CMChecicCControl 幸* ctrlHdl,  LPoint  pt, 
void  (本 procPtr) 0 ) ; 

返り 値は、 パー トコード ま たは リ ザル トコー ド。 
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$A29B  CMRefer 


引 数 ► 

word 

ctrllD 

long 

winPtr 

返り 値 ► 

DO.L 

リ ザル ト コード 

; リ ソース で NTL’ の IDX16 
; ウインド ウレ コー ドへの ポイ ンタ 


A0 .  L  コント ロ  ー ル レコ ー ド への ハンドル 

機 能 ►  winPtr で 指定した ウィンドウ のなかに リソース タイプ 'CNTL，、 の ctrllD 
と して 定義され ている コント ロー ル テン プレー トの 内容に 従って 新しい コント 
口 ー ルを 作成す る。 

再配置が 発生す る。 


C  の 関数 ►  Control  *  *  CMRefer  ( int  ctrllD,  Window  *winPtr) ; 


返り 値は コント ロ ー ル レコ ー ド への ハンドル。 
エラーの 場合は NULL が 返る。 


$A29C  CMTitleGet 


引 

数- 

long 

CtrlHdl 

; コントロール レコ _ ドへの ハンドル 

long 

strLPtr 

; LASCII 型の 文字列 バッファへの ポイ ンタ 

返り 値 

DO.L 

リザルト コ ー ド 

機 

能- 

CtrlHdl で 指定した コント ロールの タイ トルを、 strLPtr で 指定した 文字列 

バッファに 返す。 

疑似 ポイ ンタも 可。 

C  の 関数 ►  int  CMTitleGet  (Control  **ctrlHdl , const  .LASCII  *strLPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A29E  CMDraws 


引 数 ►  long  winPtr  ; ウィンドウ レコー ドへの ポインタ 

long  rgnHdl  ; リージョン レコー ドへの ハンドル 

返り 値*^  D0.L  リザルト コード 

機 能 ►  WinPtr で 指定した ウィン ドウ 上の コント ロール （可視の もの） のうち、 rgnHdl 
で 指定 した リージョンの 内部に 一部で も 含まれる ものを すべて 揃 晒す る。 

再 配 霞が 発生す る。 

C の 関数 ►  int  CMDraws  (Window  *winPtr,  Region  幸* rgnHdl ) ; 

返リ 値は リ ザル トコ ー ド。 


$A29F  CMTitleSet 
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ctrlHdl 


; コント ロ  ール レコ ー ドへの ハン ドル 


コン h 口ールマン 


long  strLPtr  ;  LASCII 型の 义字 列への ホ インタ 

返り 値 ►  D0.L  リザ ル トコード 

機能 ►  ctrlHdl で 指定した コン トロールの タイ トルを StrLPtr で 指定した 文字列に 
変更し、 再揣 画する。 

疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ►  int  CMTitleSet (Control  **ctrlHdl , const  —LASCII  *strLPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A2A0  CMOptionGet 


引 数 ►  long  CtrlHdl  ; コント ロー ル レコー ドへの ハンドル 

返り 値 ►  D0.L  コント ロール オプション （下位 ワー ドの み 意味を 持つ） 

機 能 ►  CtrlHdl で 指定した コント ロー ルの コント ロー ル オプション （cOption) を 
返す。 

C の 関数 ►  unsigned  short  CMOptionGet  (Control  **ctrlHdl) ; 

返り 値は コント ロール オプション。 


$A2A1  CMOptionSet 


引 数 ►  long  CtrlHdl  ; コント ロー ル レコー ドへの ハンドル 

word  cOpt  ; コント ロー ル オプション 

返り 値 ►  なし 

機 能 ►  CtrlHdl で 指定した コント ロー ルの コント ロー ル オプション （cOption) を 
設定す る。 

C の 関数 ►  void  CMOptionSet  (Control  **ctrlHdl,  int  c 雌 t) ; 

返り 値は ない。 


$A2A2  CMUserGet 


引 数 ►  long  CtrlHdl  ; コント ロー ルレ コードへの ハンドル 

返り 値 ►  D0.L  ユーザ 用の ワークの 値 

機 能 ►  CtrlHdl で ホ 旨ました コント ロー ルの ユーザ 用の ワーク （cUser) を 返す。 
C の 関数 ► long  CMUserGet  (Control  **ctrlHdl) ; 

返り 値は ューザ 用 ワーク の 値。 


$A2A3  CMUserSet 
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引 数 ► long 


CtrlHdl 


; コントロール レコー ドへの ハンドル 
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; ユーザ 用の ワークの 値 


long  cUser 
返り 値 ►  なし 

機 能 ►  ctrlHdl で 指定した コントロールの ユーザ 用の ワーク （cUser) を 設定す る。 
C の 関数 ►  void  CMUserSet ( Cont r 〇 1  **ctrlHdl,  long  cUser) ; 

返り 値は ない。 


$A2A4 

CMProcGet 

引 数 

long 

CtrlHdl 

; コントロール レコ'- ドへの ハンドル 

返り 値 

DO.L 

ドラ ッ グ 時の 手統き のア ドレス 

機能 ► 

ctrlHdl で 指定 した コント ロ 

— ルの ドラッグ 時の 手続きの アドレス (cProc) 

を 返す。 

$A2A5 

CMProcSet 

引 数- 

long 

CtrlHdl 

; コントロール レコー ドへの ハンドル 

long 

cProc 

; ドラッグ 時の 手続きの アドレス 

返り 値 > 

なし 

機 能- 

CtrlHdl で 指定 した コント ロ 

— ルの ドラッグ がの 手統 きの アドレス (cProc) 

を 設定す る。 

$A2A6 

CMDefDataGet 

引 数 

long 

CtrlHdl 

; コント ロ ー ル レコー ドへの ハン ドル 

返り 値*^ 

DO.L 

定義 関数の データ 

機 能 > 

CtrlHdl です 旨定 した コント ロ 

ー ルの 定義 関数の データ (cDefData) を 返す。 

C の 関数 ► 

long  CMDefDataGetiControl  **ctrlHdl) ; 

返り 値は 定義 間数の データ。 

$A2A7 

CMDefDataSet 

引 数- 

long 

CtrlHdl 

; コント ロ*- ル レコー ドへの ハン ドル 

long 

cDefData 

; 定義 閒 数の データ 

返り 値- 

なし 

機 能 ►  ctrlHdl で 指定した コントロールの 定義 関数の データ (cDefData) を 設定 
する。 

C の 関数 ►  void  CMDe/DataSet (Control 幸* ctrlHdl,  long  cDefData) ; 

返り 値は ない。 


ン ho— ルマン 


368 


ダイアログ マン 


ダイアログ マン 


#include  《DIALOG. H> 


$A2C0  DMInit 


引数 なし 
返り 値 ►  なし 

機 能 ►  ダイアログ マンを 初期化す る。 ウィンド ウマンを 初期化した あとに 呼ぶ こと。 

再配置が 発生す る。 

C の 関数 ►  void  DMInit  (void) ; 

返り 値は ない。 


$A2C2  DMFontSet 


引 数 ►  word  f ontKind  ; フォント々 インド 

返り 値 ►  なし 

機 能 ►  ダイアログ 中で 使われる フォント カ インドを 指定す る。 デフォルトは 0  (民 0M12 
フォント）。 

この 設定は グローバル であり、 の J 峰、 開かれる ダイアログ すべてに 影響す る。 さ 
ら に、 画面が 態を 保存す る モードでは、 この 設定 も 保存され るので、 注意が 必 
要で ある。 

再配置が 発生す る。 

C の 関数 ►  void  DMFontSet ( int  fontKind) ; 

返り 値は ない。 


$A2C3  DM 日 pen 


引 数*^ 


long 

dlgPtr 

long 

boundRectPtr 

long 

titleLStrPtr 

word 

visible 

word 

wDefID 

ダイアログ レコー ドへの ポイ ンタ 
レク タング ルレ コー ドへの ポイ ンタ 
LASCII 型の 文字列への ポイ ンタ 
可視 フラグ 

リ ソース ‘WDEF’ の IDX16  + オプション 


オプション 

bitO 

ス クロ ー ル バー 

bitl 

クリ  ップ 

bit2 

ドライ ブ 表示 

bits 

サイ ズ ボタン 
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返り 値 


機能 


C の 関数 • 


long 

behindWinPtr 

; ウインド ウレ コー ドへの ポイ ンタ 

word 

cBox 

; クローズ ボタン フラグ 

long 

taskID 

； タスク ID 

long 

itemHdl 

; ダイアログ アイテム リス ト への ハン ドル 

DO.L 

リ ザル トコ ー ド 

AO.L 

ダイアログ レコー 

ドへの ポイ ンタ 

新しい ダイアログを 開く。 

dlgPtr は、 新しく 作成す る ダイアログの ダイアログ レコー ド が 納め られる 場 
所を 示す ポインタ。 0 を 指定す ると、 ダイアログ マンが ヒープ 上に 作成す る。 
titleLStrPtr は、 ダイアログ タイ トルを 示す LASCII 型の 文字列への ポイ 
ンタ。 

visible として- 1 を 指定す ると ダイアログは 可視と なり、 0 を 指定す ると 不 
可視と なる。 

behindWinPtr は、 この ダイア ロ グの 上に 表示され る ウィンドウの レコー ドへ 
の ポインタを 指定す る。 -1 を 指定す ると 最も 手前に、 0 を 指定す ると 最も 奥 
に 置かれる。 通常は- 1 を 指定す る。 

cBox として- 1 を 指定す ると、 クローズ ボタンを 描画す る。 0 の 場合は 描画し 
ない。 通常は 0 を 指定す る。 

再配置が 発生す る。 

Dialog  *DMOpen (Dialog  *dlgPtr ,  Rect  *bomidRectPtr , 
const  _LASCII  titleLStrPtr ,  BOOLEAN  visible, 
int  wDefID,  Window  *behindWinPtr ,  BOOLEAN  cBox, 
long  taskID,  .Handle  本本 itemHdl) ; 

返り 値は ダイアログ レコードへの ポイ ン タ。 

エラーの 場合は NULL が 返る。 


$A2C4 


DMRef er 


引 数 ►  word  dialogID  ; リ ソース ‘DLOG， のの 

long  dlgPtr  ; ダイアログ レコードへの ポインタ 

long  behindWinPtr  ; ウイ ンド ウレ コー ドへの ポイ ンタ 

返り 値 ►  DO.L  リ ザル トコ ー ド 

AO.L  ダイアログ レコー ドへの ポイ ンタ 

機 能 ►  リソース タイプ‘ DL 日 G’、 の dialogID として 定義され ている ダイアログ テン 
プレートの 内容に 従って 新しい ダイアログを 作成す る。 

dlgPtr は、 新しく 作成す る ダイアログの ダイアログ レコードが 納められる 場 
所を 示す ポインタ。 0 を 指定す ると、 ダイアログ マンが ヒープ 上に 作成す る。 
behindWinPtr は、 この ダイアログの 上に 表示され る ウイ ン ドウの レコー ドへ 
の ポインタを 指定す る。 -1 を 指を すると 最も 手前に、 0 を 指定す ると 最も 奥 
に 置かれる。 通常は- 1 を 指定す る。 
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再配置が 発生す る。 

C の 関数 ►  Dialog  *DAffiefer(int  dialogID,  Dialog  *dlgPtr , 
Window  *behindWinPtr) ; 

返リ 値は ダイアログ レコードへの ポイ ンタ。 

エラー の 場合は NULL が 返る。 


$A2C5  DMClose 


引 数 ►  long  dlgPtr  ; ダイアログ レコー ドへの ポインタ 

返り 値 D0.L  リザルト コード 

機 能 >  dlgPtr で 指定した ダイアログを 閒じ 、ウィンドウ リストから 削除す る。 
ダイアログ レコードを ヒー プ 上の^ 外に 作成して いた 場合に 使用す る。 
再配置が 発生す る。 

C  の 関数 ►  int  DMClose  (Dialog  幸 dlgPtr) ; 


$A2C6  DMDispose 


引 数 ► long  dlgPtr  ; ダイアログ レコー ドへの ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  dl 呂 P む： で 指定した ダイアログを 閉じ、 ウィンドウ リストから 削除す る。 
ダイアログ レコードを ヒープ 上に 作成して いた 場合に 使用す る。 
再配置が 発生す る。 

C  の 関数 ►  int  DMDispose  (Dialog  *dl がれ）； 


$A2C7  DMControl 


引 数 ► long  procPtr  ; フイ ルタ 関数の アドレス 

返り 値 ►  D0.L  アイテム 番号/リザ ル トコー ド 

機 能- カレントの ダイアログ 中の、 帰還 属性を 持つ アイテム カぶ 左 クリックされ るまで、 
アイテムの 操作を 斤う。 左 クリックした アイテムを 強調し、 その上で マウス ボ 
タンが 離された 場合、 その アイテム 番号を 返す。 アイテムが ス クロー ルバ ー等 
の 場合は ドラ ッ グを 終了 した 時点で アイ テム 番号を 返す。 
procPtr は、 DMControl 実行中に 受け取った イ ベント を 操作す るた めの フィ 
ルタ [销 数の アドレス。 必要がない 場合は 0 を 指定す る。 フィルタ 闕 数には 次 
の 引数が スタ ッ ク 経由で 渡される。 

long  dlgPtr  ; ダイアログ レコー ド への ポイ ンタ 

long  eventRec  ; イベント レコー ドへの ポイ ンタ 
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結果は イ ベン トレ コードに 返す。 

再配置が 発生す る。 

C の 関数 ►  int  DMControUint  (*procPtr)  (Dialog  *dlgPtr , 
Event  *eventRec) ) ; 

返り 値は アイテムを 号 またはり ザル トコ ー ド。 


$A2C8 

DMDraw 

引 数 

丄〇 ng  dlgPtr 

; ダイアログ レコードへの ポインタ 

返り 値 

DO .  L  リ ザル トコー ド 

機 能 > 

dlgPtr です 旨ました ダイア 
再配置が 発生す る。 

ログ 内の すべての アイテムを 描画す る。 

C の 関数 > 

int  DMDraw  (Dialog  *dlgPtr) ; 

返り 値は リ ザル トコー ド。 

$A2CF 

DIGet 

引 数- 

long  dlgPtr 

； ダイアログ レコードへの ポインタ 

word  ItemNo 

; アイ テム 番号 

long  typeBuf Ptr 

; アイテム タイプが 返る バッファへの ポインタ 

long  hdlBufPtr 

； アイテム レコ ー ドの ハン ドル カ s' 返る バッファ 

への ポイ ンタ 

long  rectBufPtr 

; アイテムの レク タング ルが 返る バッファへ 

の ポインタ 

返り 値 

DO .  L  リ ザル トコ ー ド 

機 能- 

dlgPtr で 指定した ダイア 

ログ 中の、 アイテム 番号 itemNo で 示される アイ 

テムに 関する 情報を typeBuf  Ptr,  hdlBuf  Ptr ,  rectBufPtr で 示される 

バッファに 返す。 
typeBuf  Ptr  は 1 ワード、 

hdlBufPtr  は 1 日ング ワード、 rectBufPtr  は 2 

ロング ワードの ワーク の アドレスを 指して いる こと。 

再配置が 発生す る。 

C の 関数 ► 

int  DIGet  (Dialog  幸 dlgPtr,  int  itemNo ,  short  幸 typeBuf Ptr, 
Handle  *hdlBufPtr,  Rect  *rectBuf Ptr) ; 

返り 値は リ ザル トコー ド。 

$A2D0 

DISet 

引 数 ►  long  dlgPtr  ; ダイアログ レコード への ポイ ンタ 

word  itemNo  : アイ テム 齋号 
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word 

itemType 

； アイテム タイプ 

long 

itemHdl 

; アイテム レコー ドへの ハン ドル 

long 

rectPtr 

; アイテムの 大きさを 示す レク タング ル レコ 

DO.L 

リ ザル トコー ド 

ド への ポイ ンタ 

機能 ►  dlgPtr で 指を した ダイア ロ グ中 の アイテム 番号 it  emNo で 示される アイテム 
に、 itemType,  itemHdl , rectPtr で 示される 情報を 設定す る。 

コント ロール マンの アイ テムの 場合、 コント ロー ルの バウ ン ドレ ク タング ルは 
影響を 受けない。 

再配置が 発生す る。 

C の 関数 ►  int  DJSet (Dialog  *dlgPtr ,  int  itemNo ,  short  itemType , 
Handle  itemHdl,  Rect  *rectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A2D1 

DITGet 

引 数- 

word 

itemType 

; アイ テム タイプ 

long 

itemHdl 

; アイテム レコー ドへの ハン ドル 

long 

StrLPtr 

; LASCII 型の 文字列 バッファへの ポイ ンタ 

返り 値 

DO.L 

リ ザル トコー ド 

機 能 ►  itemType,  itemHdl で 指を した アイテムの タイトルを、 strLPtr で 指定し 
た 文字列 バッファに 返す。 itemHdl は、 $A2CF  DIGet で 返された ものを 使 
う 。 

疑似 ポイ ンタも 可。 

再配置が 発生す る。 

C の 関数 ►  int  DITGet (short  itemType ,  Handle  itemHdl , 

-LASCII  strLPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A2D2  DITSet 


引 数 ►  word 

itemTvoe 

long 

itemHdl 

long 

StrLPtr 

返り 値 ►  DO.L 

リ ザル ト コード 

機 能- 


C の 関数 ► 


アイテム タイプ 

アイテム レコ ー ドの ハン ドル 

LASCII 型の 文字列 バッファへの ポイ ンタ 


itemType,  itemHdl で ホ旨定 した アイテムの タイ トルを、 strLPtr で ホ 旨定し 
た 文字列に 変更す る。 itemHdl は、 $A2CF  DIGet で 返された ものを 使う。 
疑似 ポイ ンタも 可。 

再配置が 発生す る。 

int  DITSet  (short  ite  虹  Tvpe,  Handle  itemHdl, 
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const  _LASCII  strLPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A2D3 

DITSelect 

引 数 ► long 

dlgPtr 

; ダイアログ レコ _ ドへの ポインタ 

word 

itemNo 

; アイテム 番号 

long 

start 

； 選択 1 菲) 始 オフセット 

long 

end 

; 選が 終了 オフセット 

返り 値 ►  DO . L 

リ ザル トコ ー ド 

機 能 ►  dlgPtr で 指定した ダイアログ 中の、 itemNo で 指ました アイテム （編集 可能 
テキスト のみ） の、 start 文字から end 文字までを 選択が 態に する。 end と 
して $7FFFFFFF を 指定す ると、 文字列の 最後までが 選択状態になる。 
再配置が 発生す る。 

C の 関数 ►  int  DJTSeiect (Dialog  *dlgPtr ,  int  itemNo , long  start, 
long  end) ; 

返り 値は リ ザル トコ ー ド。 


$A2D6  DIUpdate 

引 数 ► long  dlgPtr  ; ダイアログ レコードへの ポインタ 

long  rgnHdl  ; リージョン レコードへの ハンドル 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機能 ►  dlgP む： で 指定した ダイアログ 中の、 rgnHdl で 示された リージョン じ 一部で 
も 含まれる アイテムを すべて 再 描画す る。 

再配置が 発を する。 

C の 関数 ►  int  DJUpdate (Dialog  *dlgPtr,  Region  **rgnHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A2D7  DMBeep 


引 数 ►  word  count  ;BEEP を 鳴らす 回数 

返り 値 ►  D0.L  リザ ル トコード 

機 能 BEEP 音を （count  -1) 回 鳴らす。 

C の 関数 ►  int  DM 及 eep(int  count) ; 

返り 値は リ ザル トコ ー ド。 
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$A2D8  DIHide 


引 数 ► long  dlgPtr  ; ダイアログ レコードへの ポインタ 

word  itemNo  ; アイテム 番号 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  dlgPtr で 指定した ダイアログ 中の、 アイテムを 号 itemNo で 示される アイ テ 
ムを 不可視 じして 表示を 消ます る。 

再配置が 発生す る。 

C の 関数 ►  int  DJ 曲 ‘deCDia^g  *dlgPtr ,  int  itemNo) ; 

返り 値は リザルト コード。 


$A2D9  DIShow 


引 数 ► long  dlgPtr  ; ダイアログ レコードへの ポインタ 

word  itemNo  ; アイ テム 番号 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  dlgPtr で 指定した ダイアログ 中の、 アイテム 番号 itemNo で 示される アイ テ 
ムを 可視に して 再 表示す る。 

再配置が 発生す る。 

C  の 関数 ►  int  DIShow  (Dialog  *dlgPtr ,  int  itemNo) ; 

返り 値は リ ザル トコ ー ド。 


$A2F6  DMError 


引数 word 

flags 

long 

返り 値 ►  DO.L 

StrZPtr 

アイテムを 号/ リ ザル 

; ダイアログの 形式を 指定す る フラグ 


上位 バイト 

パ ター ンモ ー ド 

$00 

黄 フラッグ 

$01 

ホフ ラッグ 

$80 

F1 クラッシュ アニメーション 

下位 バイト 

ボタン モード 

$01 

確認 

$04 

はい/いいえ 

$05 

登録/終了 

$06 

実行/取り消し 

$07 

継続/中止 

; エラー/警告 メ ッ セージ 

ト コード 


機 能 ►  flags で 指定した 形式の 簡易 エラーメッセージ 用 ダイアログを 作成し、 その内 
部に strZPtr で 指定され た 文字列を 表示す る。 アイテムが 左 クリック される 
のを 待ち、 アイテム 番号を 返す。 

义字列 中に 適宜 C 民 コード ($0D) を 入れる ことで 改行す る。 
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再配置が 発生す る。 

C の 関数 ►  int  DMError (Int  flags ,  const  char  *strZPtr) ; 
返り 値は アイテム 番号、 または リザルト コード。 


$A2F7  DMWaitOpen 


引 数 なし 

返り 値 ►  D0.L  リザルト コード 

A0.L  ダイアログ レコ ー ドへの ポイ ンタ 

機 能 ►  ウュイ ト ダイアログ （"しばらく お待ち 下さい’’ ダイアログ） を 表示す る。 
再配置が 発生す る。 

C の 関数 ►  int  DMWaitOpen  (void) ; 

返り 値は リ ザル トコ ー ド。 


$A2F8  DMWaitClose 


引 数- なし 

返り 値 ►  DO.L  リ ザル トコ ー ド 
機 能 ►  ウて イト ダイアログを 消ます る。 
再配置が 発生す る。 

C の 関数 ►  int  DMWaitClose  (void) ; 
返り 値は リ ザル トコ ー ド。 


$A2F9  DMWaitWhile 


引数- なし 

返り 値 ►  D0.L  リ ザル トコ ー ド 

AO.L  ダイアログ レコ ー ドへの ポイ ンタ 

機能 ► ウ卫 イト ダイアログの 踏切の 絵を 描き 直す。 前回の 描き 直しから 1 秒の 《上 経過 
していた 場合、 次の パターンに 描き 換える。 

ウュ イト ダイアログ 表示 中は 適当な 間隔を 置いて 呼び 続ける こと。 

再配置が 発生す る。 

C の 関数 ►  int  DM W— ait W も パ e( void) ; 

返り 値は リ ザル トコ ー ド。 


$A2FA  DMError2  r~ao 
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; ダイアログの 形す を 指定す る フラグ 


ダイアログ マン 


上位 バイト 

パ ター ンモー ド 

$00 

黄 フラッグ 

$01 

赤 フラッグ 

$02 

F1 クラッシュ アニメーション 

$04 

ューザ 定義 

$80 

黒 フラッグ 

下位 バイト 

ボタン モード 

$00 

ューザ 定義 

$01 

確認 

$04 

はい/いいえ 

$05 

登録/終了 

$06 

実 斤/取り消し 

$07 

継綻 /中止 

long  strZPtr  ; エラー/警告 メ ツセー ジ 

long  patTblPtr  ; パターン テー ブルへの ポイ ンタ 

long  bttnTblPtr  ; ボタン テー ブルへの ポインタ 

long  pcmLength  ;  ADPCM デー タの バイト 数 

long  pcmDataPtr  ;  ADPCM デー タ への ポイ ンタ 

返り 値 ►  D0.L  アイテム 番号/リザルト コード 

機 能 flags で 指定した 形式の 簡易 エラー メッセージ 用 ダイアログを 作成し、 その内 
部に StrZPtr で 指定され た 文字列を 表示す る。 アイテムが 左 クリック される 
のを 待ち、 アイテム 番号を 返す。 

flags で ユーザ 定義の パ ターン や ボタンを 指定した 場合、 patTblPtr が 示す 
パ ターン テー ブル や bttnTblPtr が 示す ボタ ン テー ブルが 参照 される。 

ノ 、。 ターン テー ブルの 構造は U 下の とおり。 
patTbl : 


dc.l 


dc.l 


rectlmgPtrl  ; 1 コマ 目の レク タング ルイ メー 

ジへの ポイ  ンタ 

count 1  ; 表示 間隔 (1/100 秒 単位） 


dc.l 


0 


; エン ド マーク 


パターンは テキス ト タイプ 3 ページの レク タング ル イメージ。 2 コマの 指定 
した 場合は、 それぞれの コマの 表示 間隔に 従って アニメー ショ ン する。 

ボタン テーブルの 構造は じ I 下の とおり。 
bttnTbl : 


dc.l 


bttnStrZPtrl 


dc.l  flag! 


1 個 目の ボタンの 文字列への ポ 
インタ 

=  0  ューザ 定義 ボタン 

= 1  デフォルト ボタン 


dc.l 


0 


; エン ド マーク 


ボタンの 文字列は、 半角 10 文字までの ASCIIZ 型 文字列。 

pcmLength が 0 の^ 外の 場合、 ダイア ロ グ 表示 時 じ pcmDataPtr で 指定され 
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た ADPCM データ （15kHz) を 鳴らす。 

再配置が 発生す る。 

C の 関数 ►  int  DMError2 i±nt  f；Ugs，char  *strZPtr ,ErrPat  *patTblP れ， 
ErrBttn  ♦bttnTblPtr ,  int  pcmLength, 
unsigned  char  *pcinDataPtr) ; 

返り 値は アイテム 番号、 または リザルト コード。 
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引数- なし 

返り 値 ►  DO.L  リザルト コード 
機能 >  テキスト マンを 初期化す る。 

再配置が 発生す る。 

C の 関数 ►  int  TMI 打な （void) ; 

返り 値は リ ザル トコ ー ド。 


$A30C 


TMSetRect 


引 数- 


返り 値 
機 能 > 


long 

long 

long 

DO.L 


tEHdl 

destRectPtr 

viewRectPtr 

リ ザル トコー ド 


テキス トエ デイ ッ トレ コー ドへの ハン ドル 
レ クタ ン グルレ コー ドへの ポイ ンタ 
レ クタ ン グルレ コー ドへの ポイ ンタ 


t 邸 dl で 指定した テキスト エディット レコー ドに、 destRectPtr,  viewRect 
Ptr で 示された レク タング ルを セットし、 再 表示す る。 

再配置が 発生す る。 

C の 関数 ►  int  TMSetRect (TEdit  **!: 酣 dl,  Rect  *destRectPtr , 

Rect  *viewRectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A30D 


TMChangText 


引 

数- 

long 

tEHdl  ; 

テキスト エディッ トレ コー ドへの ハン ドル 

long 

textPtr  ; 

テキス ト への ポインタ 

long 

length  ; 

テキス トの バイト 数 

返り 値 ► 

DO.L 

新しく セット された テキス トの バイ ト数 

/ リザ ル トコー ド 

機 

能- 

tEHdl 

で 指定した テ ネス ト エディ 

ッ ト レコー ド じ textPtr と length で 指 

定 した テキストを 編集 用に セットし、 再 表示を 斤う。 

疑似 ポイ ンタも 可。 

再配置が 発を する。 

C の 関数 ► long  TMChangeText (TEdit  **tEHdl,  const  char  幸 textPtr, 
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long  length) ; 

返り 値は、 セット された テキストの バイト 数。 


$A30E  TMIdle 


引 数 ► long  t 拙 dl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  t 酣 dl で 指定され た テキスト エディット レコードの々 ー ソルの 点滅 化理を 駆動 
する。 あらかじめ、 固 的の グラフ レコードを々 レント にしておく 必要が ある。 
再 目 己 置が 発生す る。 

C の 関数 ►  int  TMIdledEdit  **t 拙 dl) ; 

返り 値は リ ザル トコー ド。 


$A311  TMCaret 


引 数- 


返り 値 ► 
機能- 


long  tEHdl 

word  皿 ode 


; テキス トエ デイ ッ トレ コー ドへの ハン ドル 
; 々ー ソルの モード 


0 

消す 

1 

表示す る 

D0.L  リ ザル トコー ド 

tEHdl で 指定した テキスト エディット レコー ドの 力ー ソルの が 態を 皿 ode に 
従って 設定す る。 

再配置が 発生す る。 


C の 関数 ►  int  TMCaret (TEdlt  **tEHdl, int  mode); 


返り 値は リ ザル トコ ー ド。 


$A312  TMDispose 


引 数 ► long  t 拙 dl  ; テキスト エディット レコードへの ハンドル 

返り 値- DO.L  リ ザル トコー ド 

機 能 ►  tEHdl です 旨を した テキスト エディット レコードを 廃棄す る。 編集 テキスト も 廃 
棄 される。 

再配置が 発生す る。 

C の 関数 ►  int  TMDisposeiTEdit  **tEHdl) ; 

返り 値は リ ザル ト コード。 


$A313  TMUpDate 
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弓 1 数 ► long  tEHdl 


; テキスト エディツ トレ コー ドへの ハン ドル 
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long 

updtRectPtr 

; レク タング ルレ コードへの ポインタ （口一 
々ル 座標） 

返り 値*^ 

D0.L 

リ ザル トコ ー ド 

機 能 ► 

t 拙 dl で 指定され た、 テ ネス ト エディット レコー ドの 編集 テ ネス ト の、 updtRect 

Ptr で 指を した レク タング ルで 示される 範 聞を 再 表示す る。 あらかじめ 目的の 
グラフ レコードを カレン ト じして おく 必要が ある。 

再配置が 発生す る。 

C の 関数 ►  int  TMUpDate (TEdit  幸* tEHdl,  Rect  *updtRectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A314 

TMSetText 

引 数- 

long 

tEHdl  ; 

テキス トエ デイ ッ トレ コー ドへの ハン ドル 

long 

textPtr  ; 

テキス ト への ポイ ンタ 

long 

length  ; 

テキス トの バイト 数 

返り 値 

DO.L 

リ ザル トコード 

機能- 

tEHdl 

で 指定した テキス ト エディ 

ッ トレ コー ドに、 texlPtr と length で 

指定した テキストを 編集 用に セッ ト する。 再 表示は 斤わない。 

疑似 ポインタ も 可。 

再配置が 発生す る。 

C の 関数 ►  int  TMSetText (TEdit  **1: 拙 dl, const  char  *textPtr , 
long  length) ; 

返り 値は リ ザル トコ ー ド。 


$A315 

TMGetText 

引 数 

long 

tEHdl 

; テキスト エディツ トレ コー ドへの ハン ドル 

long 

buffPtr 

； 編集 テキスト を 返す バッファの ポインタ 

long 

lenMax 

; ハ •ツ ファの サイズ 

返り 値 

DO.L 

編集 テキス トの バイト 数 

/ リザルト コード 

AO.L 

バッファに 返された テキストの 終端 +1 

機 能 > 

tEHdl 

で 指定され た テキスト エディット レコー ドの 編集 テキストを、 buffPtr 

で 指を された バッファに 返す。 返される 編集 テキストの バイ ト 数が lenMax を 
超える 場合は エラーと なる。 編集 テキストの 終端には $00 が 置かれて いないの 
で 注意。 

再 配證が 発生す る。 

C  の 関数 ► long  T M  Get  Text  (TEdit  **tEHdl , char  幸 textPtr  ,long  lenMax) ; 
返り 値は、 編集 テキス トの バイ ト数 または リザルト コード。 
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$A316 

TMSetSelect 

引 数- 

long 

tEHdl 

; テキス ト エディッ トレ コー ドへの ハン ドル 

long 

selStart 

; セレク ト範關 の 先頭 位置の オフセット 

long 

selEnd 

; セレク ト 範囲の 終端 位置の オフセット 

long 

selOf f set 

; 前の セレ ク ト 位置の オフセット 

返り 値*^ 

DO.L 

り ザル トコー ド 

機 能 ►  tEHdl で 指定され た テキスト エディット レコー ドの 編集 テキストの セレクト 
領域を selStart ,  selEnd で 指定した 領域に 新たに 設定し、 再 表示す る。 
selGffset は、 前の セレクト 位置の 開始 位置 あるいは 終了 位置を 指を する。 
開始 位置を 変更す る 場合は 前の 開始 位歷 を、 終了 位置を 変更す る 場合は 前の 終 
了 位置を 指定す る。 

再 配證が 発生す る。 

C の 関数 ►  int  TMSetSeiect (TEdit  **tEHdl , long  selStart , long  selEnd, 
long  selOff set) ; 

返り 値は リ ザル トコ ー ド。 


$A317 

TMKey 

引 数- 

long 

tEHdl 

; テキス トエ デイ ッ トレ コー ドへの ハン ドル 

word 

keyChax 

； 入カ キャラクタ 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

0 

編集し なかった 

1 

編集した 

機 能 ►  t 拙 dl で 指を された テキスト エディット レコードの 編集 テキストに、 keyChar 
で 指定され た キャラクタを 入力して 再 表示す る。 あらかじめ、 目的の グラフ レ 
コードを カレント にしておく 必要が ある。 

マルチ フォン ト テキス ト エディ ッ トの增 合、 々レン トの スタイル 情報で 入力 さ 
れ る。 

再配置が 発生す る。 

C の 関数 ►  int  TMKey (TEdit  **tEHdl,  int  keyChax) ; 


返り 値は、 

編集 結果 または リ ザル ト コード。 

$A318 

TMStr 

引 数- 

long 

tEHdl 

； テキスト エディッ トレ コー ドへの ハン ドル 

long 

textPtr 

; テキス ト への ポイ ンタ 

long 

length 

; テキス トの バイト 数 

返り 値*^ 

DO.L 

リ ザル トコ ー ド 
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0 

編集し なかった 

1 

編集した 

機 能 t 拙 dl で 指を された テキスト エディット レコードの 編集 テキストの セレクト 領 
域を、 textPtr で 指定した 文字列と 置き換える。 CR($OD)  外の 制御 コー 
ドを 含める ことは できない。 再 表示は 行わない。 

マルチ フォン ト テキス ト エディッ トの 場合、 カレン トの スタイル 情報で 入力 さ 
れ る。 

再配置が 発生す る。 

C の 関数 ►  int  TMStr (TEdit  幸* t 甜 dl ,cons"t  char  *textPtr , long  length) ; 
返り 値は、 編集 結果 または リザルト コード。 


$A319  TMCalText 


引 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  t 邸 dl で 指定した テキスト エディットの 段落 情報を 計算/設定 する。 力ーソル 
の 位置な どは 変更され ない ので、 通常は $A464  TMSetSelCal を 利用す る。 再 
表示は 巧 われない。 

再配置が 発生す る。 

C の 関数 ►  int  TMCaiText (TEdit  * け 拙 dl) ; 

返り 値は リ ザル トコ ー ド。 


$A31A  TMPinScroll 


引 数 ►  long  tEHdl  ; テキスト エディット レコー ドへの ハンドル 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  t 邸 dl で 指を された テ ネスト エディット レコー ドの 編集 テキストの セレクト 部 
分が ビュー レク タング ルに 収ま るよう に スクロールさせる。 実際に スクロール 
した 場合は 再 表示を 行う。 

あらかじめ、 目的の グラフ レコードを々 レン ト にしておく 必要が ある。 
再配置が 発生す る。 

C の 関数 ►  int  TMPinScra/K 咒 dit  **t 拙 dl) ; 

返り 値は リ ザル トコ ー ド。 


$A31B  TMClick 


引 数 ►  long  tEHdl  ; テキスト エディット レコー ドへの ハンドル 

long  pt  ; マウスが 左 クリック された ポイント （口一 

カ  ル 座標） 
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返り 値 ► 
機 能 


word  extend  ; 動作 モード 


0 

新規 セレ ク ト 領域 

1 

前圆の セレ ク ト 領域を 変更 

2 

セレ ク ト 領域 開始 位置の 変更 

3 

セレ ク ト 領域 終了 位置の 変更 

D0.L  リ ザル トコ ー ド 

t 拙 dl で 指定され た テキスト エディット レコードの セレクト 領域を、 マウスに 
よって 変更す る。 pt じは、 マウスが 左 クリック された 座標を 入れる。 
あらかじめ、 白 的の グラフ レコー ドを カレン ト にしておく 必要が ある。 
再配置が 発生す る。 


extend で 指定した 値 じよって 動作が 異なる。 
extend が 0 の 場合 


pt で 指を し た位證 と マウス の 左 ボタ ンを 離し た 位置が、 セレクト 領 
域の 開始 位證、 終了 位置と なる。 
extend 力 《 1 の 場合 

前回 指定した セレ ク ト 領域の 開始 位置は 固定で、 その 位置と マウス 
の 左 ボタンを 離した 位置が、 セレクト 領域の 郎] 始 位置、 終了 位置と 
なる。 

extend が 2 の 場合 

前回 指定した セレ ク ト 領域の 終了 位置が 新しい セレ ク ト 領域の 終了 
位證 に、 マウスの 左 ボタンを 離した 位 蘆が 新しい セレ ク ト 領域の 關 
始 位置と なる。 
extend が 3 の 場合 

前回 指定した セレ ク ト 領域の 開始 位置が 新しい セレ ク ト 領域の 郎始 
位 鼠に、 マウスの 左 ボタンを 離した 位屢が 新しい セレ ク ト 領域の 終 
了 位置と なる。 

C の 関数 ►  int  TMCiicif (TEdit  **tEHdl , LPoint  pt,  int  extend) ; 

返り 値は リ ザル トコ ー ド。 


$A31C 

TMEvent 

引 数- 

返り 値 

Ion 良 
long 

DO.L 

tEHdl 

eventRecPtr 

リ ザル ト コード 

; テキス トエ ディ ッ ト レコー ドへの ハン ドル 
; イベント レコー ドへの ポイ ンタ 

0 

編集し なかった 

1 

編集した 

機 負 居 ►  tEHdl で 指を された テキスト エディット レコー ドに ついて、 eventRecPtr で 
指を された イベント レコードの 内容に 対応す る 化理を 斤う。 あらかじめ、 目的 
の グラフ レコ ー ドを々 レント にしておく 必要が ある。 

再配置が 発生す る。 

対応す るのは、 じ I 下の 4 つの イベント。 これらの 化理の あと、 再 表示が 巧 われ 
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る。 

•ヌル イベント 

々ー ソルの 点滅を 斤う。 

■マウス レフト ダウン イベント 

セレ ク ト 領域の 変更を 斤う。 

•マウス ライト ダウン イベント 

ポップアップ メニューを 表示して、 テキス ト マンス クラップとの 間 
で カット & ペースト を 斤う 0 
• キー ダウ ン イベント 

キャラクタの 入力を 行う （全角に も 対応）。 カーソル ネー、 BS キー、 
DEL キーに 対応す る。 

C の 関数 ►  int  TMEvent (TEdlt  幸* tEHdl,  TsEvent  *eventRecPtr) ; 

返り 値は、 編集 結果 または リザルト コード。 


$A320  TMCut 


引 数 ►  long  tEHdl  ; テキスト エディット レコー ドへの ハンドル 

返り 値 ►  D0.L  リ ザル トコ ー ド 


0 

編集し なかった 

1 

編集した 

機 能 ►  t 拙 dl で 指定され た テキスト エディット レコードの 編集 テキストの セレクト 領 
域を カットし、 テキスト マンス クラップ じ 移し、 再 表示す る。 あらかじめ、 目 
的の グラフ レコ ー ドを々 レン ト じして おく 必要が ある。 

マルチ フォン ト テキス ト エディッ トの 場合、 スタイル 情報 も テキス ト マンス ク 
ラップに 移される。 

再配置が 発生す る。 

C の 関数 ►  int  TMCut  (TEdlt  **tEHdl) ; 

返り 値は、 編集 結果 または リザルト コード。 


$A321  TMCopy 


引 数 ► long  t 拙 dl  ; テ ネスト エディット レコードへの ハンドル 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  t 拙 dl で 指を された テキスト エディット レコー ドの 編集 テキストの セレクト 部 
分を テキスト マンス クラップ じ コピーし、 再 表示す る。 あらかじめ、 目的の グ 
ラフ レコードを々 レン ト にしておく 必要が ある。 

マルチ フォン ト テキス ト エディッ トの 場合、 スタイル 情報 も テキス ト マンス ク 
ラ ップに 移される。 

再配置が 発生す る。 

C の 関数 ►  int  TMCo 只 パ咒 dit 幸* t 拙 dl) ; 
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返り 値は リ ザル トコ ー ド。 


$A322  TMPaste 


引 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  D0.L  リザ ル トコー ド 


0 

編集し なかった 

1 

編集した 

機 能 ►  t 甜 dl で 指を された テキスト エディット レコー ドの 編集 テキストの セレクト 領 
域を テキスト マンス クラップの 内容と 置き換え、 再 表示す る。 あらかじめ、 目 
的の グラフ レコ ー ドを カレント にしておく 必要が ある。 テキスト マンス クラ ッ 
プの 内容は 変化し ない。 

マルチ フォン ト テキス ト エディ ッ トの 場合、 スタイル 情報 も ペースト される。 
再配置が 発生す る。 

C の 関数 ►  int  TMPasteiTEdit  **tEHdl) ; 

返り 値は、 編集 結果 または リザルト コード。 


$A323  TMDelete 


引 数 ►  Ion 良  t 拙 dl  ; テ ネスト エディット レコードへの ハンドル 

返り 値- D0.L  リザルト コード 


0 

編集し なかった 

1 

編集した 

機 能 ►  tEHdl で 指定され た テ ネスト エディット レコードの 編集 テキストの セレクト 領 
域を 消 まし、 再 表示す る。 テキスト マンス クラップの 内容は 変化し ない。 あら 
か じめ、 目的の グラフ レコ ー ドを カレント にしておく 必要が ある。 

再配置が 発生す る。 

C の 関数 ►  int  TMDeiete (TEdit  * が酣 dl) ; 

返り 値は、 編集 結果 または リザルト コード。 


$A324  TMInsert 


引 数 

long 

tEHdl 

long 

strPtr 

long 

length 

返り 値 ► 

DO.L 

リ ザル ト コード 

0 

編集し なかった 

1 

編集した 

テキス トエ デイ ッ トレ コー ドへの ハン ドル 
文字列の ア ドレス 
文字列の バイ ト数 


機 能 ►  tEHdl で 指定した テキスト エディットの セレクト 領域と strP れ で 指定した 
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文字列を 置き換えて 再 表示す る。 

マルチ フォント テキスト エディット の 場合、 カレント のス タイ ル 情報で 入力 さ 
れ る。 

再配置が 発生す る。 

C の 関数 ►  int  TMInsert (TEdit  **tEHdl,  const  char  *strPtr , 
long  length) ; 

返り 値は、 編集 結果 または リザルト コード。 


$A325 

TMFromScrap 

引 数- 

なし 

返り 値- 

D0.L  リザ ル トコー ド 

機能- 

デスクトップ スクラップの 内容を、 テ ネスト マンス クラ 

再配置が 発生す る。 

ッ プにコ ピーす る。 

C の 関数- 

int  TMFromScrap  (void) ; 

返り 値は リ ザル トコ ー ド。 

$A326 

TMToScrap 

引 数*^ 

なし 

返り 値 ► 

D0.L  リ ザル トコー ド 

機 能 ► 

テキスト マンス クラップの 内容を、 デスクトップ ス クラ 

再配置が 発生す る。 

ッ プにコ ピーす る。 

C の 関数 ► 

int  TMToScrap  (void) ; 

返り 値は リ ザル トコ ー ド。 

$A327 

TMScrapHandle 

引 数- 

なし 

返り 値*^ 

D0.L  リザルト コード 

A0.L  テキス ト マンス クラップへの ハン ドル 

機能- 

テキスト マンス クラ ップの ハン ドルを 返す。 

C の 関数 > 

int  TMScrapnandleiUandle  本 scrapHdl) ; 
結果は ハンドル scrapHdl じ 格納され る。 

返り 値は リ ザル トコ ー ド。 

$A328 

TMGetScrapLen 

テキス h マン 


引数 >  なし 
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返り 値 ►  DO.L  テキスト マンス クラップの バイト 数 

い、 ザル トコード 

機 能 ►  テキスト マンス クラップの バイト 数を 返す。 

C の 関数 ► long  TMGetScrapLen  (void) ; 

返り 値は、 テキス ト マンス クラップの バイ ト数 または リザ ル トコ ー ド。 


$A32B  TMTextBox2 


引 数 ► long 

textPtr 

long 

length 

long 

destRectPtr 

word 

虹 ode 

word  lineHeight 

返り 値 ►  DO.L  リ ザル トコ ー ド 


文字列への ポインタ 
文字列の バイト 数 
レ クタ ン グルレ コー ドへの ポイ ンタ 
斤 揃え モード 


0 

左 寄せ 

1 

センタリング 

-1 

右 寄せ 

； 改行 幅の ドット 数 


機 能 ►  textPtr で 指定した 文字列を 皿 ode で 指定した 斤 揃え じし、 destRectPtr 
で 指定され たレク タング ルに 納まる ように 表示す る。 あらかじめ、 目的の グラ 
フ レコードを カレント にしておく 必要が ある。 
textPtr ,  destRectPtr は 疑似 ポインタ も 可。 

再配置が 発生す る。 


C の 関数 ►  int  TMTextBox2 ( c ons t  char  *textPtr,  long  length, 
Rect  *destRectPtr ,  int  mode,  int  lineHeight) ; 

返り 値は リ ザル トコ ー ド。 


$A32C  TMCacheON 


引 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

long  size  ; キャッシュの バイ ト数 

返り 値 ►  DO.L  リザルト コード 

機 台 長 ►  t 拙 dl で 指定した テキスト エディット レコード じついて、 size で 指定した サ 
イズの キャッシュを 用意し、 ON にす る。 

再配置が 発生す る。 

C の 関数 ►  int  TMCacheON (TEdit  **t 酣 dl,  long  size) ; 

返り 値は リ ザル トコ ー ド。 


$A32D  TMCacheDFF 
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弓  I  数 ► long  tEHdl 


; テキスト エディツ トレ コー ドへの ハン ドル 
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返り 値 ►  DO.L  リザ ル トコー ド 

機 能 ►  tEHdl で 指定した テキスト エディット レコー ドの キャッシュを 廃棄し、 OFF じ 
する。 

再配置が 発生す る。 

C の 関数 ►  int  TMCacheOFF (TEdit  **tEHdl) ; 

返り 値は リザ ル トコ ー ド。 


$A32E  TMCacheFlush 


引 数 ► long  tEHdl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 自良 •-  t 拙 dl で 指定した テキスト エディット レコー ドの キャッシュを フラッシュ する。 
再配置が 発生す る。 

C の 関数 ►  int  TMCacheFlush  (TEdit  **1:甜(11); 

返り 値は リ ザル ト コード。 


$A32F  TMShow 


引 数 ►  long  tEHdl  ; テキスト エディット レコー ドへの ハンドル 

返り 値 ►  DO.L  ドロー レベルを + 1 した 結果の 値 

機 能 ►  tEHdl で 指定した テキスト エディット レコー ドの ドローレベルを + 1 する。 再 
描画は 斤わない。 

C の 関数 ►  int  TMSiiowCTEdit  **tEHdl) ; 

返り 値は 化理 後の ドロー  レベル。 


$A330  TMHide 


引 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  DO.L  ドロー レベルを 一1 した 結果の 値 

機 能 ►  tEHdl で 指定した テキスト エディット レコードの ドロー レベルを 一1 する。 再 
揣 画は 斤わない。 

C の 関数 ►  int  TMffic/e (咒 dit  **tEHdl) ; 

返り 値は 化理 後の ドロ ー  レベル。 


$A331  TMSelShow 


引 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  DO.L  ハイライト 表示 レベルを + 1 した 結果の 値 


テキス h マン 


389 


テキス K マン 


機 能 ►  tEHdl で 指定した テキスト エディット レコードの ハイライト 表示 レベルを 十 1 
する。 再 画は 行わない。 

C の 関数 ►  int  TMSeiShow (TEdit  **tEHdl) ; 

返り 値は 化理 後の ハイ ライ ト 表示 レベル。 


$A332  TMSelHide 


引 数 ► long  t 拙 dl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  D0.L  ハイライト 表示 レベルを 一1 した 結果の 値 

機 能 ►  tEHdl で 指定した テ ネスト エディット レコードの ハイライト 表示 レベルを 一1 
する。 再 描画は 巧わない。 

C の 関数 ►  int  TMSeiHideCTEdit  **tEHdl) ; 

返り 値は 化理 後の ハイ ライ ト 表示 レベル。 


$A333 

TMSearchStrF 

引 数- 

long 

tEHdl 

テキス ト エディツ トレ コー ドへの ハン ドル 

long 

strPtr 

検索 文字列への ポインタ 

long 

length 

検索 文字列の バイト 数 

long 

off setl 

テ ネス トの 検索 關始 位置 （オフセット） 

long 

off set2 

テキス トの 検索 終了 位置 （オフセット） 

long 

procPtr 

フィルタ プロセスの アドレス （0 で 指定し 
ない） 

返り 値 ► 

DO.L 

発見した 文字列の 位置 （オフセット） 

=-1 発見で きなかった 

AO.L 

発見した 文字列の バイト 数 

機 能 > 

tEHdl 

で 指定した テキス ト エディ 

ットの off  setl,  offsets で 示される 範 

囲で、 strP れ で 指定した 文字列を 前方 検索す る。 大文字 小文字 等は 区別され 
る。 

procPtr で 指定す る フィルタ プロセスは、 檢 索化理 中、 適当な 間隔で 呼び出 
される。 引数と して、 A0 に tEHdl が 渡される。 返り 値と して DO に 0 じ I 
外を 返す と、 検索は 中断され、 TMSearchStrF の 返り 値と して フィルタ プロ セ 
スの返 リイ 直が アプリ ケー シヨ ンじ 返される。 

再配置が 発生す る。 

C の 関数 ►  int  TMSearchStrF (TEdit  幸* tEHdl,  const  char  *strPtr , 
long  length , long  off setl , long  offsets, 
int  (*procPtr) (TEdit  **tEHdl) , long  *size) ; 

返り 値は 発見した 文字列の 位置 （オフ セッ ト）。 

int 塑の 変数 size に 発見した 文字列の バイ ト 数が 格納され る。 
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$A334  TMSearchStrB 


引 数- 

long 

tEHdl 

テキス トエ デイ ッ ト レコー ドへの ハン ドル 

long 

StrPtr 

檢索 文字列への ポインタ 

long 

length 

検索 义字 列の バイト 数 

long 

off setl 

テキス トの 検索 關始 位置 （オフセット） 

long 

offsets 

テキス トの 検索 終了 位置 （オフセット） 

long 

procPtr 

フイ ルタ プロセスの ア ドレス （0 で 指定し 

ない） 

返り 値 ► 

DO.L 

発見した 文字列の 位置 （オフセット） 

=-1 発見で きなかった 

AO.L 

発見した 文字列の バイト 数 

機 能 ►  t 拙 dl で 指定した テキスト エディットの offset し offsets で 示される 範 
囲で、 strPtr で 指定した 文字列を 後方 検索す る。 大文字 小文字 等は 区別され 
る。 

procPtr で 指定す る フィルタ プロセスは、 検索 化理 中、 適当な 間隔で 呼び出 
される。 引数と して、 A0 に tEHdl が 渡される。 返り 値と して DO に 0 じ I 
外を 返す と 検索は 中断され、 TMSearchStrB の 返り 値と して フィルタ プロ セ 
スの 返り 値が アプリ ケー ショ ンに 返される。 

再配置が 発生す る。 

C の 関数 ►  int  TMSearchStrB (TEdit  **tEHdl,  const  char  *strPtr , 
long  length,  long  off setl , long  of f set2, 
int  (*procPtr) (TEdit  **tEHdl) , long  本 size) ; 

返り 値は 発見した 文字列の 位置 （オフセット）。 

int 型の 変数 size に 発見した 文字列の バイ ト 数が 格納され る。 


$A335  TMText InWidth2 


弓 I 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

long  StrPtr  ; 文字列への ポイ ンタ 

long  offset  ; 文字列の オフセット 

word  width  ; 文字列を 納める 幅 （ドッ ト 数） 

word  startPoint  ; 文字列の ローカル 座標 ー デイ ステ イネー シヨ 

ンレク タング ルの 水平 方向 オフセット 
返り 値 >  DO.L  納まる 文字列の バイ ト 数/リザルト コード 

A0.L  =0  改行 コードり I 外の 理由で 終了した 

丰り  改行 コード じよ り 終了した 

機 能 ►  tEHdl で 指定した テキスト エディット レコードの 環境 下で、 StartPoint で 


指定した 位置から StrPtr,  offset で キ旨定 される 文字列を 描画す る 場合、 
width で 指定した ドッ ト 数の 幅に 納まる 文字 数を 計算し、 結果を 返す。 
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$A197  GMStrLength とは コント ロール コー ドの 化理が 異なる。 $0A,  $0D (な 
斤 コード） が あった 場合、 そこまでで 文字 数の 計算を 終了し、 $09  (TAB コー 
ド） が あった 場合、 TAB サイズ （teTabSize) に 従って タブの 処理を 行う。 ま 
た、 他の コントロール コー ドの 場合、 編集 モード （teDrawMode) じ 従って 計 
算を 斤う。 

マルチ フォント テキスト エディットの 場合、 offset じは 編集 テキスト 先頭 か 
らの オフ セッ トを 指を する 必要が ある。 

再配置が 発生す る。 

C の 関数 ►  int  TMTextInWidth2 (TEdlt  **tEHdl,  const  char  *strPtr , 
long  offset , int  width, int  staxtPoint , BOOLEAN  幸 e 打 dMode) ; 
返り 値は 納まる 文字列の バイ ト 数。 

BGOLEAN 型の 変数 endMode には、 終了した 理由を 意味す る 値が 格納され る。 


$A336  TMTextWidth2 


引 

数- 

long 

t 拙 dl 

テキス ト エディツ トレ コー ドへの ハン ドル 

long 

strPtr 

文字列への ポインタ 

long 

offset 

文字列の オフセット 

word 

length 

文字列の バイト 数 

word 

startPoint 

文字列の 口一々 ル 座標 ー ディ ステ ィネー シヨ 
ンレク タング ルの 水平 方向 オフセット 

返り 値 

DO.L 

文字列の 占める 幅 （ドッ ト 数）/ リザ ル ト コード 

機 

能 

tEHdl 

で キ旨定 した テキス ト エディ 

ッ トレ コードの 環境 下で、 StartPoint で 

指を した 位置から strPtr,  offset,  length で 指定され る 文字列を 描画 
する 場合、 それが 占める 幅 （ドッ ト 数） を 計算し、 結果を 返す。 

$A196  GMStrWidth とは コントロール コー ドの 化理が 輿なる。 $0A,  $0D (改 
斤 コード） が あった 場合、 そこまでで ドッ ト 数の 計算を 終了し、 $09  (TAB コー 
ド） が あった 場合、 TAB サイズ （teTabSize) じ 従って タブの 化理を 斤う。 
また、 他の コントロール コー ドの 場合、 編集 モード （teDrawMode) に 従って 
計算を 行う。 

マルチ フォント テキスト エディットの 場合、 offset には 編集 テキスト 先頭 か 
らの オフ セッ トを 指定す る 必要が ある。 

再配置が 発生す る。 

C の 関数 ►  int  TMTextWidth2 (TEdit  **t 拙 dl,const  char  *strPtr , 
long  offet,  int  length,  int  staxtPoint) ; 

返り 値は、 文字列の 占める 幅 または リザ ル ト コード。 


$A337  TMDrawText2 
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引 数 ► long 


tEHdl 


; テキスト エディツ ト レコー ドへの ハン ドル 
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long 

strPtr 

文字列の ア ドレス 

long 

offset 

文字列の オフセット 

word 

length 

文字列の バイト 数 

word 

startPoint 

文字列の ロー々 ル 座標ーデイ ス テイ ネー シヨ 
ンレク タング ルの 水平 方向 オフセット 

word 

tabMode  = 

=  0  タブは ペン 位置を 移動す る だけ 

牛り タブは バックグラウンド々 ラーに よる 

塗り つぶし 

返り 値 ►  DO.L 

リ ザル トコー ド 

機 能 ►  t 拙 dl で 指定した テキスト エディット レコードの 環境 下で、 startPoint で 
指* 定 した 位置から strPtr,  offset,  length で 指を される 文字列を 描画 
する。 あらかじめ ビュー レク タング ルで クリ ップ 領域を 設定して おく 必要が あ 
る。 

$A の 6  GMStrWidth とは コントロール コー ドの 化理が 異なる。 $0A,  $0D (な 
巧コー ド） が あった 場合、 そこまでで 描画を 終了し、 $09(TAB コー ド） があっ 
た 場合、 TAB サイズ （teTabSize) におって タブの 化理を 斤う。 また、 他の コ 
ン トロ ー ルコ ー ドの 場合、 編集 モ ー ド （teDrawMode) に f 走って 描画す る。 
マルチ フォント テキスト エディットの 場合、 offset じは 編集 テキスト 先頭 か 
らの オフ セッ トを 指定す る 必要が ある。 

再配置が 発生す る。 

C の 関数 ►  int  TMDrawText2 ( TEdi t  **tEHdl,  const  char  *strPtr , 

long  offset , int  length, int  start Point , BOOLEAN  tabMode) ; 
返り 値は リ ザル トコ ー ド。 


$A338 

TMUpDate2 

引 数- 

Ion 良 

t 酣 dl 

; テキス トエ デイ ッ ト レコー ドへの ハン ドル 

long 

hisRecPtr 

; 編集 履歴 レコー ドへの ポインタ 

返り 値 

DO.L 

リ ザル トコ ー ド 

機 能 ► 

hisRecPtr で 指定した 編集 履歴 レコードに 従って tEHdl で 指定した テキス 

ト エディ ッ トの揣 画を 斤う。 

再配置が 発生す る。 

C の 関数 ► 

int  TMUpDate2  (TEdit  **tEHdl,  TEH  is  *hisRecPtr) ; 

返り 値は リ ザル トコー ド。 

$A339 

TMUpDateS 

引 数 ■- 

long 

tEHdl 

; テキスト エディッ トレ コー ドへの ハン ドル 

long 

updtRectPtr 

; レク タング ル レコー ドへの ポインタ （ロー 

々ル 座標） 
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返り 値 ►  DO.L  リザルト コード 

機能 ►  tEHdl で 指定した テキスト エディットの updtRectPtr で 指定した レク タン 
グルで 示される 範囲を 再 表示す る。 $A313  TMUpDate との 違いは、 ノ、* ックグ 
ラウンド カラー じよる 塗りつ ぶ しを 行わない 点。 

再配置が 発生す る。 

C の 関数 ►  int  TMUpDateS (TEdit  **t 拙 dl, Rect  *updtRectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A33A 

TMCalCOLine 

引 数 ► 

long 

t 拙 dl 

; テキス ト エディツ トレ コー ドへの ハン ドル 

long 

columnPtr 

； 段落 情報を 作成す る バッファ （$18 バィト） 
への ポイ ンタ 

long 

offset 

； 段落 位置 

返り 値 

DO.L 

リ ザル トコ ー ド 

機 能 

tEHdl 

で 指定した テキスト エディットの、 offset で 指定した 段落 位置 （段落 

の 通し番号） の 段落 情報を columnPtr からの バッファ じ 作成す る。 

再配置が 発生す る。 

C の 関数 ► 

long  TMCalCOLine (TEdit 
long  of iset) ; 

返り 値は リ ザル トコー ド。 

**tEHdl,  TEColumn  *coluinnPtr , 

$A33C 

TMCalLine 

引 数- 

long 

tEHdl 

; テキス トエ デイ ッ ト レコー ドへの ハン ドル 

long 

columnPtr 

; 段落 情報を 作成す る バッファけ 18 バイト） 
への ポイ ンタ 

long 

offset 

； 斤 位置/バイ ト 位置 

0 


offset は バイ ト 位置 
offset は 行 位置 


返り 値 
機 能 


DO.L 


こ の 段落の バイト 位置/り ザル トコ ー ド 

tEHdl て’、 ホ旨定 した テキスト 卫 ディ ッ ト の、 offset で 寸旨定 した イ于 位置 (mode=l 
の 場合）、 あるいは バイ ト 位置 (mode=  0 の 場合） の 段落 情報を、 columnPtr 
からの バッファに 作成す る。 

再配置が 発生す る。 

C の 関数 ►  int  TMCalLine (TEdit  **tEHdl,  TEColmnn  *columnPtr , 
long  offset ,  BOOLEAN  mode) ; 

返り 値は、 段落の バイ ト 位置 または リザルト コード。 
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$A33D 


TMLeftSel 


引数 ► long 
返り 値 ►  DO . L 


; テキス ト エディツ トレ コー ドへの ハン ドル 


tEHdl 

オフセット 

=-1 セレ ク ト 領域が テキス トの 先頭 

機 能 ►  tEHdl で 指定した テキスト エディットの セレクト 領域の 直前 （1 つ 左） の 位置 
を 返す。 

C の 関数 ► long  TMLejftSei (TEdit  ♦*tEHdl) ; 

返り 値は オフセット。 


$A33E 


TMRightSel 


引 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  DO.L  オフセット 

=-1 セレ ク ト 領域が テキス トの 最後 

機 能 ►  tEHdl で 指定した テキスト エディットの セレクト 領域の 直後 （1 つ 右） の 位置 
を 返す。 

C の 関数 ►  int  TMRightSeUTEdit  **tEHdl) ; 

返り 値は オフセット。 


$A33F 


TMPointSel 


引 数 ► long 

tEHdl  ; 

テキス ト エディツ ト レコー ドへの 

long 

xpoint  ; 

水平 座標 （ローカル 座標） 

long 

ypoint  ; : 

垂直 座標 （ローカル 座標） 

word 

extend 

0 

新規 セレクト 領域 

1 

前回の セレ ク ト 領域を 変更 

2 

セレクト 領域 關始 位證の 変更 

3 

セレ ク ト 領域 終了 位置の 変更 

返り 値 •-  DO.L 

リ ザル トコ ー ド 

機 能 ►  tEHdl で 指定され た テキスト エディットの セレクト 位置を xpoint,  ypoint 
で 指定した 座標に よって 変更し、 再 表示す る。 セレクト 領域 変更 後に カーソル 
位置の 再 計算を 斤う が、 スクロールは 斤わない。 

再配置が 発生す る。 

C の 関数 ►  int  TMPointSel ( TEdi t  **tEHdl, int  xpoint ,  int  ypoint , 
int  extend) ; 

返り 値は リ ザル トコー ド。 
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$A340  TMOffsetSel 


引 数 

long 

tEHdl 

long 

off sett 

word 

extend 

返り 値 

DO.L 

リ ザル ト コード 

； テキスト エディツ トレ コー ドへの ハン ドル 

; バイ ト 位置 


0 

新規 セ レクト 領域 

1 

前回の セレ ク ト 領域を 変更 

2 

セレクト 領域 開始 位置の 変更 

3 

セレ ク ト 領域 終了 位證の 変更 

機 能 ►  t 拙 dl で 指を された テ ネスト エディットの セレクト 位置を、 offset で 指を 


した バイ ト 位置に よって 変更し、 再 表示す る。 セレクト 領域 変更 後に々 ー ソル 


位置の 巧 計算を 巧う 力、’、 スクロールは 斤わない。 


再配置が 発生す る。 

C の 関数 ►  int  TMOffsetSel (TEdit  幸* tEHdl,  long  offset ,  int  extend) ; 
返り 値は リザ ル トコ ー ド。 


$A341  TMPointToLine 


引 

数 

long 

tEHdl 

テキス ト エディツ ト レコー ドへの ハン ドル 

long 

xpoint 

水平 座標 （ロー々 ル 座標） 

long 

ypoint 

垂直 座標 （ローカル 座標） 

long 

columnPtr 

段落 情報を 作成す る バッファけ; 18 バイト） 
のア ドレス 

返り 値 ► 

DO.L 

この 段落の バイ ト 位置/リザルト コード 

AO.L 

段落 情報を 作成す る バッファへの ポインタ 

機 

能- 

tEHdl 

で 指ました テキスト エディ 

ッ ト の、 xpoint ,  ypoint で 指定した 座標 

の 段落 情報を columnPtr からの バッファに 作成す る。 

再配置が 発生す る。 

C の 関数 ► 

long  T MPoint ToLin e ( TEdit 

幸 本 tEHdl, 11 It  又 point, 11 It  ypoint , 

TEColumn  幸 co 丄 umnPtr) ; 

返り 値は、 段落の バイ ト 位置 または リザルト コード。 


$A343  TMCalSelPoint 


引 数 ►  long  tEHdl  ; テキスト エディット レコー ドへの ハンドル 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 >  t 拙 dl で 指を された、 テキスト エディットの 現を の セレクト 領域の 行 位置と 座 
樵を 再 計算す る。 

再配置が 発生す る。 

C の 関数 ►  int  TMCalSelPoint  (TEdit  本が 拙 dl) ; 
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$A345 

TMSetView 

引 数 

long 

tEHdl 

; テキス ト エディッ トレ コー ドへの ハン ドル 

long 

viewRectPtr 

; レク タング ルレ コードへの ポインタ 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

機能 > 

t 邸 dl 

で 指定した テキス ト エディツ ト のビュ ーレク タング ノレと して、 viewRect 

Ptr で 指定した レク タング ルを 設定す る。 

再配置が 発生す る。 

C の 関数 ►  int  TMSet View (咒 dit 

幸* tEHdl,  Rect  *viewRectPtr) ; 

返り 値は リ ザル トコー ド。 

$A346 

TMScroii 

引 数 

long 

tEHdl 

; テキス トエ デイ ッ トレ コー ドへの ハン ドル 

long 

dh 

； 水平 方向に スクロールさせる ドット 数 

long 

dv 

; 垂直 方向に スクロールさせる ドット 数 

返り 値 ► 

DO.L 

リザ ノレ トコ ー ド 

機能 ►  t 拙 dl で 指定 した テ ネスト エディットを 地， dv で 指定した ドット だけ 横 •縦 
に スクロール させ、 再 表示す る。 dh は 正で 右、 負で 左方 向へ、 dv は 正で 下、 
負で 上方 向に スクロール する。 

再配置が 発生す る。 

C の 関数 ►  int  TMScroii (TEdit  幸* tEHdl, int  她， int  dv) ; 

返り 値は リ ザル トコ ー ド。 


$A347 


TMPointScroll 


引 

数 ► 

long 

tEHdl 

; テキスト エディツ ト レコー ドへの ハン ドル 

long 

xpoint 

； 水平 座標 （ローカル 座標） 

long 

ypoint 

; 垂直 座標 （ローカル 座標） 

返り 値 ► 

DO.L 

リ ザル トコー ド 

機 

能 •- 

tEHdl 

で 寸旨定 した テキス ト エディツ トの ビュー レク タング ノレに xpoint ,  ypoint 

で 指定した 座標 力ぶ 納まる ようじ スクロール させ、 再 表示す る。 

再配置が 発生す る。 

C の 関数 ►  int  TMPointScroll  (TEdit 

本本 tEHdl,  int  xpoint ,  int  VDoint) ; 

返り 値は リ ザル トコ ー ド。 


テキス h マン 


397 


テキス h マン 


$A348  TMStr2 


引 数 ► long 

t 拙 dl 

; テキス ト エディッ トレ コー ドへの ハン ドル 

long 

strPtr 

; テキス ト への ポインタ 

long 

length 

； テキス トの バイト 数 

long 

hisRecPtr 

； 編集 履歴 レコー ド への ポインタ 

返り 値 ►  DO.L 

リ ザル トコ ー ド 

0 

編集し なかった 

1 

編集した 

機 能 ►  t 拙 dl で 指定され た テキスト エディット レコードの 編集 テキストの セレクト 
領域を strPtr で 指定した 义字 列と 蘆き 換え、 編集 履歴 レコードを 作成す る。 
カーソル 位置の 再 計算は 斤 われない。 

再 表示は 行わない。 

マルチ フォン ト テキス トエ ディ ッ トの 場合、 カレン トの スタイル 情報で 入力 さ 
れ る。 

再配置が 発生す る。 

C の 関数 ►  int  TMS か 2(TEdit  **t 酣 dl ’const  char  *strPtr  ,long  length , 
TEH is  本 hisRecPtr) ; 

返り 値は、 編集 結果 または リザルト コード。 


$A349 

TMKeyToAsk 

引 数- 

long 

tEHdl 

; テキス ト エディッ トレ コー ドへの ハン ドル 

long 

eventRecPtr 

; イベント レコ ー ド への ポインタ 

返り 値 ► 

DO.L 

リザ ノレ トコ ー ド 

-1 キー コー ドが 格納され ていない 

-2  該当する コードが ファンク シヨ ン キー アサイ ン テーブルに 發録 
されて いない 


機 能 ►  eventRecPtr で 指定した イベント レコード じ 格納され ている キー コードを、 
t 邸 dl で 指定した テキス ト エディ ッ ト レコー ドの ファンクション キー アサイン 
テーブル によって 変換し、 イベント レコードに 再 設定す る。 

C の 関数 ►  int  T MKeyToAsk ( TEd i t  **t 拙 dl,  TsEvent  ^eventRecPtr) ; 

返り 値は、 エラー 内容 または リザルト コード。 


$A34A 

TMNextCode 

引 数 ■- 

long 

tEHdl 

； テキス ト エディット 

レコ ー ドへの ハン ドル 

word 

code 

； キー コード 

=0  すべての コー 

K 

word 

mode 

三 0  イベントを 取り除かない 
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+  0 イベント を 取り除く 

返り 値 ►  DO .  L  上位 ワ ー ド： キー コード、 下位 ワー ド： ASCII コード 

=0  指定した コー ドの キー イベントは 発見で きなかった 
機 能 ►  次の キー ダウン イベントを 先 読みし、 tEHdl で 4 •旨定 した テキスト エディット レ 
コードの キー アサイン テーブル によって キー コードを 変換した あと、 code で 
指定した キー コードで あるか どうかを チェック する。 指ました コー ドであった 
場合、 皿 ode に 0  U 外を 指定す ると、 この イベントを 取り除く。 

C の 関数 ► long  TMNe が Code (咒 dit  **tEHdl, int  code,  BOOLEAN  mode); 

返り 値は 上位 ワードが キー コード、 下位 ワードが ASCII コード。 イベントが 
発見で きなかった 場合は 0 。 


$A34B  TMSetTextH 


引 

数 

long 

tEHdl 

; テキス ト エディツ トレ コー ドへの ハン ドル 

long 

textHdl 

; テキス ト への ハン ドル 

long 

length 

； テキス トの バイト 数 

返り 値 

DO.L 

リ ザル トコード 

機 

能 

t 拙 dl 

で 指ました テキス [ 

、エディットに textHdl と length で 指定した 

テキストを 編集 用に セツ ト する。 再 表示は 斤わない。 

マルチ フォン ト テキス ト エディツ トの 場合、 々レン トの スタイル 情報で 入力 さ 
れ る。 

疑似 ハン ドルは 不可。 

再配置が 発生す る。 

C の 関数 ►  int  TMSetTextH (TEdit  **tEHdl,  char  **textHdl , 
long  length) ; 

返り 値は リ ザル トコ ー ド。 


$A366  TMOpen 


引 数 ► long 

long 

long 

word 


word 
返り 値 ►  DO.L 
AO.L 


textPtr 

maxLength 

dvRectPtr 

mode 


lineHeight 

リ ザル ト コード 


; 編集 テキストの 初期 文字列への ポインタ 
(ASCIIZ  型） 

； 編集 テキストの 最大 サイズ 
; レク タング ルレ コードへの ポインタ 
； 巧 揃え モード 


0 

左 寄せ 

1 

センタリング 

-1 

右 寄せ 

； 改行 幅の ドット 数 


テ ネス トェ デイ ッ ト レコー ドへの ハン ドル 
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機能 ►  textPtr で 指ました 义字 列を あらかじめ セットした maxLength までの 文字 
列が 編集 可能な テキス ト エディ ッ トレ コードを 作成す る。 ディスティネーション 
レク タング ル、 ビュ ーレク タング ルは、 どちらも dvRectPtr で 指定した レ 
ク タング ルと なる。 

あらかじめ、 目的の グラフ レコー ドを カレント にしておく 必要が ある。 
textPtr ,  dvRectPtr は 疑似 ポインタ も 可。 

再配置が 発生す る。 

新しく 作成され る テキス ト エディット レコードの 内容は 次のと おり。 


項目 名 

設定 内容 

デイ ステ イネ ー シヨ ンレク 
タング ル 

dvRectPtr で 巧 された レク タン グル 

ビュー レク タン グル 

dvRectPtr で 示された レク タング ル 

編集 テキス ト への ハンドル 

テキス ト マンが 作 化した ブロックの ハン ドル 

編集 テキス トの 最大 サイズ 

maxLength で 指定 した サイズ 

編集 テキス トの ブロック サ 
イズ 

テキス ト マンが 作成した ブロ ックの サイズ 

な 巧 幅 

lineHeight で 指定 さ れた ドット 数 

タブ サイズ 

48 ドット 

斤 揃え モード 

お揃え 

グラフ レコー ドへの 
ポインタ 

々レント グラフ レコ ー ドへの ポイ ンタ 

コント ロール キー テーブル 
への ポイ ンタ 

デフ オルト 

カーソル 表示 ルーチンへの 
ポインタ 

デフ オルト 

クリ ップル ー プル ー チンへ 
の ポインタ 

デフ オルト 

行頭 テー ブル 

64 行 分 U 上 

その他 

0 

C の 関数 ►  int  TMOpeniconst  char  ♦textPtr,  long  maxLength , 
Rect  幸 dvRectPtr,  int  皿 ode,  int  lineHeight , 

TEdit  幸 本 幸 tEHdl); 

結果は 咒 dit 型の ハンドル t 邸 dl に 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A401  TMNew2 


引 

数- 

long 

destRectPtr  ; 

レ クタ ン グルレ コー ドへの ポイ ンタ 

long 

viewRectPtr  ; 

ビュー レク タン グルへの ポインタ 

long 

graphPtr  ; 

グラフ レコー ドへの ポイ ンタ 

返り 値 ► 

DO.L 

リ ザル トコー ド 

AO.L 

テキス ト エディット レコ 

— ドへの ハン ドル 

機 

能- 

destRectPtr ,  viewRectPtr で、 それ ぞ: 旨定 された デイ ステ イネ 
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ンレク タング ル、 ビュー レク タング ルを 持つ テキス ト エディ ッ ト レコー ドを 作 
成す る。 

再 配 霞が 発生す る。 

新しく 作成され る テキス ト エディット レコ ー ドの 巧容 はみ のと おり。 


項目 名 

設定 内容 

デイ ス テイ ネー シヨ ンレク 
タ ン グル 

destRectPtr で 示 された レク タング ル 

ビュー レ クタ ン グル 

viewRectPtr で 示された レ クタ ン グル 

編集 テ ネス ト への ハンドル 

テキス ト マンが 作成した ブロ ックの ハンドル 

編集 テキストの 嚴大 サイズ 

0 

編集 テキス トの ブロック サ 
イズ 

0 

改行 幅 

カレント グラフ レコードに セットされ ている 
フォン トの y 方向の サイズ 

タブ サイズ 

48  K ット 

斤 揃え モード 

左 揃え 

グラフ レコー ドへの ポ イン 
夕 

graphPtr で 指定 した グラフ レコー ド への ポ 
インタ 

コント ロール キ_ テーブル 
への ポイ ンタ 

デフ ォルト 

力 ー ソ ル 表示 ル ー チ ン への 
ポインタ 

デフ ォルト 

クリ ップ ループ ルー チンへ 
のポイ ンタ 

デフォルト 

行頭 テーブル 

64 行 分] a 上 

その他 

0 

C の 関数 ►  int  TMJVew2(Rect  *destRectPtr ,  Rect  *viewRectPtr , 
Graph  *graphPtr,  TEdit  幸** tEHdl) ; 

結果は、 TEdit 狸の ハンドル tEHdl じ 格納され る。 

返り 値は リ ザル トコー ド。 


$A460  TMNextCodeIn 


引 

数 

long 

tEHdl 

; テキス ト エディツ トレ コー ドへの ハン ドル 

word 

code 

； キー コード 

三 0  すべての コード 

返り 値 ► 

DO.L 

上位 ワード： 

キ ーコー ド、 下位 ワード： ASCII コード 

=0  指定した コードの キー イベントは 発見で きなかった 

機 

能 > 

次の キー 

ダウン イベントを 先 読みし、 tEHdl で 指定した テキスト エディット レ 

コードの キー アサイン テーブルに よって キー コー ドを 変換した あと、 code で 
指定した キー コー ドで あるか どうかを チェック する。 指定した コードを 含む イ 
ベント が 発生す るまで、 すべての キー ダウン イベント を 取り除く。 

C の 関数 ►  int  TMNextCodeIn  (TEdit  **tEHdl,  int  code) ; 
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返り 値は、 上位 ワードが ネー コード、 下位 ワードが ASCII コード。 
イベントが 発見で きなかった 場合は 0 。 


$A462  TMSelReverse 


引 

数- 

Ion 良 

tEHdl 

; テキス トエ デイ ッ トレ コー ドへの ハン ドル 

long 

selStart 

； 關始 位置 （バイ ト 位置） 

long 

selEnd 

； 終了 位置 （バイ ト 位置） 

返り 値 

DO.L 

リ ザル トコ ー ド 

機 

能- 

tEHdl 

で 指定 した テキスト エディットの selStart ,  selEnd で 指定し た範 

囲を 反 松 表示す る。 ハイ ライ ト 表示 属性が 負の 場合は 何もし ない。 

再配置が 発生す る。 

C の 関数 ►  int  TMSelReverse  (TEdit 

幸* tEHdl,  long  selStart , 

long  selEnd) ; 

返り 値は リ ザル トコ ー ド。 


$A463  TMTini 


引数 なし 

返り 値 D0.L  リ ザル トコ ー ド 
機 能 ►  テキスト マンの 終了 処理を 斤う。 

再配置が 発生す る。 

C の 関数 ►  int  TMTini  (void) ; 

返り 値は リ ザル トコー ド。 


$A464 

TMSetSelCal 

引 数 long 

tEHdl 

; テキス ト エディツ トレ コー ドへの ハン ドル 

long 

selStart 

; セレ ク ト範 脚の 先頭 位置の オフセット 

long 

selEnd 

; セレ ク ト範 四の 終端 位置の オフセット 

long 

selOf f set 

; 前の セレ ク ト 位置の オフセット 

返り 値 ►  DO.L 

リ ザル トコ ー ド 

機 能 ►  t 拙 dl で 指定され た テキスト エディット レコー ドの 編集 テキストの セレクト 領 
蛾を selStart ,  selEnd で 指定した 領域に 新たに 設定し、 全体を 計算し 直 
す。 再 表示は 巧わない。 selOffset は、 前の セレクト 位置の 開始 位置 あるい 
は 終了 位置を 指定す る。 開始 位置を 変更す る 場合は 前の 開始 位置を、 終了 位置 
を 変更す る 場合は 前の 終了 位置を 指定す る。 

再配置が 発生す る。 

C の 関数 ►  int  TMSetSelCal (TEdit  **tEHdl, 10 ng  selStart, long  selEnd, 


402 


long  selOff set) ; 
返り 値は リ ザル トコ ー ド。 
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$A465  TMActivate2 


引 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  tEHdl で 指定した テキスト エディット レコードの ハイライト 表示 レベルを + 1 
して、 々ー ソルを 表示す るか、 あるいは セレクト 領域を 反転 表示す る。 
再配置が 発生す る。 

C の 関数 ►  int  TMActivate2 (TEdlt  幸* t 酣 dl) ; 

返り 値は リ ザル トコー ド。 


$A466  TMDeactivate2 


引 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  t 拙 dl で 指定した テキスト エディット レコードに ついて、 力ー ソルを 消 まある 
いは セレクト 領域の 反較 表示を 消した あと、 ハイライト 表示 レベルを 一1 す 
る。 

再配置が 発生す る。 

C の 関数 ►  int  TMDeactivate2(TEd±t  **tEHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A467 

TMCheckSel 

引 数*^ 

long 

tEHdl 

; テキスト エディッ ト レコー ドへの ハ 

ン ドル 

long 

selStart 

; セレク ト 範囲の 先頭 位置の オフ セッ 

卜 

long 

selEnd 

; セレク ト 範囲の 終端 位置の オフ セッ 

卜 

long 

selOff set 

; 前の セレ ク ト 位置の オフセット 

返り 値 ► 

DO.L 

リ ザル トコード 

機 能 ►  tEHdl で 指定され た テ ネスト エディット レコー ドの 編集 テキストの セレクト 
領域を selStart ,  selEnd で 指定した 領域に 新たに 設定し、 再 表示を 斤う。 
selOffset は、 前の セレクト 位置の 開始 位置 あるいは 終了 位置を 指定す る。 
開始 位置を 変更す る 場合は 前の 開始 位置を、 終了 位置を 変更す る 場合は 前の 終 
了 位置を 指定す る。 々ー ソル 位置の 再 計算は 行わない。 

再配置が 発生す る。 

C の 関数 ►  int  TMCheckSel (TEdlt  幸* tEHdl, 10 ng  selStart , long  selEnd, 
long  selOff set) ; 
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返り 値は リ ザル トコ ー ド。 


$A468 

TMCalPoint2 

引 数 

long 

tEHdl 

テキスト エディツ ト レコー ドへの ハン ドル 

long 

offset 

バイ ト 位置 

long 

buf fPtr 

座標 情報が 返る バッファ （12 バイト） への 
ポインタ 

返り 値 ► 

AO.L 

座標 情報が 返る バッファの ア ドレス 

機 能- 

tEHdl 

で 指定した テキスト エディ 

ットの offset で 指定した バイ ト 位置の 座 

標を 計算し、 buffPtr じ 返す。 

バッファ に 返される 情報の 形式は 下の とおり。 

+$00.  L 水平 座標 
+$04.  L 垂直 座標 
+$08  .L 巧 揃えの ための 補正 値 
巧 配置が 発生す る。 

C の 関数 ►  void  TMCalPoij]t2( 咒 dit  **tEHdl,  long  offset, 
long  幸 buf fPtr) ; 

返り 値は ない。 


$A46A 

TMISZen 

引 数 ► 

long 

tEHdl 

; テキス ト エディツ ト レコー ドへの ハン ドル 

long 

offset 

; バィ ト 位置 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

0  シフト JIS コ ー ドの 1 バイト 目 
1 シフト JIS コ ー ドの 2 バイト 目 

A0.L  指定され た 位置の テキス トのア ドレス 

機 能 ►  t 拙 dl で 指定した、 テキスト エディットの offset で 指定した バイト 位置が 
シフト JIS コー ドの 何 バイト 固 かを 調べる。 

再配置が 発生す る。 

C の 関数 ►  int  TMISZen (TEdit  本本 tEHdl,  long  offset) ; 

返り 値は、 調べた 結果 または リザルト コード。 


$A46B  TMSetDestOf f set 


引 数 ► long  tEHdl 

long  oif setx 

long  offsety 


テキスト エディツ ト レコー ドへの ハン ドル 

水平 座標 オフセット 
垂直 座標 オフセット 
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返り 値 ► 
機 能 ► 


C の 関数 • 


DO.L  リザ ル トコー ド 

t 拙 dl で 指を した テキスト エディットの、 ビュー レク タング ルに 対する デ ィス 
テ ィネー シヨ ンレ クタ ン グルの オフ セッ ト として offsetx,  of  f  sety をセッ 
卜 し、 再 表示す る。 

再配置が 発生す る。 

int  TMSetDestOffset (TEdit  **tEHdl, int  of f setx,  int 
off sety) ; 

返り 値は リザルト コード。 


$A46C 


TMGetDestOf f set 


引 数- 


返り 値 
機 能- 


long  t 拙 dl  ; テキスト エディット レコー ドへの ハンドル 

long  buffPtr  ; 結果 力 {返る バッファ （8 バイト） への ポインタ 

A0.L  結果が 返る バッファへの ポインタ 

t 拙 dl で 指定した、 テ ネスト エディットの ビュー レク タング ルに 対する デ ィス 
テ ィネーシヨ ンレク タング ルの オフセットを、 buffPtr で 指定した バッファ 
に 返す。 

ノ 、•ッ ファ に 返される 情報の 形式は 下の とおり。 

+$00.  L 水平 座標 オフセット 
+$04.  L 垂直 座標 オフセット 

C の 関数 ►  void  TMGetDestOffset (TEdit  **tEHdl， long  *buf f Ptr) ; 

返り 値は ない。 


$A46D 


TMGetSelect 


引 数 I 


返り 値 I 


機能 I 


C の 関数 I 


long  tEHdl  ; テキスト エディット レコードへの ハンドル 

long  buffPtr  ; 結果が 返る バッファ （12 バイト） への ポイ 

ンタ 

D0.L  リザ ル トコー ド 

A0.L  結果が 返る バッファへの ポインタ 

tEHdl で 指定した テキスト エディッ トの 現在の セレ ク ト 状態を buffPtr で 指 
をした バッファ じ 返す。 

パ、、, つ マ に 返される 情報の 形式は 下の とおり。 

+$00  .L セレクト 側始 位置 
+$04  .L セレクト 終了 位置 
+ $08.L 現在の セレクト 位置 

int  TMGetSelect  (TEdit  *  幸  tEHdl,  long  幸  buff  Ptr) ; 

返り 値は リ ザル トコ ー ド。 
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$A46E 


TMEventW 


I  2.0 


引 数 


返り 値 


long 

long 

DO.L 


t 酣 dl 

eventRecPtr 

リ ザル ト コード 


テキス ト エディツ トレ コー ドへの ハン ドル 
イベント レコ ー ドへの ポイ ンタ 


0 


編集し なかった 
編集した 


機 能 ►  t 拙 dl で 指定した テキスト エディット レコードに 格納され ている グラフ レコー 
ド への ポイ ンタ （telnPort ) がウ ィンド ウレ コー ドへの ポインタ であ ると 仮 
定 し、 アップデート リージョンの 範圓 内を 再 描画し、 再 描画した 範囲は アップ 
デ ー トリー ジョンから 取り除く。 その後、 $A31C  TMEvent と 同様な 化 理を行 

ぅ D 

アップ デートリー ジョンを 操作す るので、 $A20D  WM 雌 date 後には 使用す る 
ことができない。 

再配置が 発生す る。 

C の 関数 ►  int  TMEven t W(TEdi t  **tEHdl,  TsEvent  *eventRecPtr) ; 

返り 値は、 編集 結果 または リザ ル トコー ド。 


$A46F 


TMUpDateExist 


I  ao 


引 数- 


返り 値 • 


long 
1011 居 


DO.L 


tEHdl 

田 ode 


リザ ノレ トコ ー ド 


; テキスト エディ ッ トレ コー ドへの ハン ドル 

=  0  描画し た 範囲 をアッ プデー ト リージ 
ョ ンカ >ら 取り 除かない 
丰。 描画した 範囲を アップデート リージ 
ョ ン から 取り除く 


0 


アップ デ ー トリー ジョ ンが 存在し ない 
アップデート リ ージョ ンを 描画した 


機 能 ►  t 拙 dl で 指定した テキスト エディット レコードに 格納され ている グラフ レコー 
ドへの ポインタ （teInPort) が 勺 ィンド ウレ コー ドへの ポインタ であ ると 仮 
定 し、 アップデート リージョンの 範圃 内を 再 描画し、 mode が 0U 外の 場合は 
再 描画した 範囲を アップ デ ー トリー ジョ ン から 取り除く。 

アップ デー トリー ジョンを 操作す るので、 $A20D  WMUpdate 後には 使用で き 
ない。 

再配置が 発生す る。 

C の 関数 ►  int  TMUpDateExist (TEdit  幸* tEHdl,  BOOLEAN  mode); 

返り 値は、 アップ デ ー ト 結果 または リザ ル ト コード。 
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$A470 


TMNewM 


3.0 


引 数 ► long  destRectPtr 


デイ ス テイ ネー シヨ ンレク タング ルへの ポ 
インタ 

ビュー レ クタ ン グルへの ポイ ンタ 
グラフ レコ ー ドへの ポイ ンタ 
ス タイ ル 情報 レコ ー ドへの ポインタ 


long  viewRectPtr 

long  graphPtr 

long  styleRecPtr 

返り 値 ►  DO •  L  リ ザル トコー ド 

AO.L  マルチ フォン ト テキス ト エディット レコー ドへの ハン ドル 

機 能 ►  destRectPtr,  viewRectPtr で それぞれ 指定され た ディ ステ ィネー ション 
レ クタ ン グル、 ビュー レ クタ ン グルを 持つ マルチ フォ ント テキスト エディット 
レコードを 作成す る。 

StyleRecPtr には、 々レントの フォント 情報と なる スタイル 情報 レコードを 
指定す る。 

再配置が 発生す る。 

C の 関数 ►  int  TMNewM (Rect  *destRectPtr ,  Rect  *viewRectPtr , 

Graph  *graphPtr ,  TEStyle  *styleRecPtr ,  MTEdit  幸** mTEHdl) ; 
結果は、 MTEdit 型の ハンドル mT 拙 dl じ 格納され る。 

返り 値は リ ザル トコ ー ド。 


$A471 


TMSetTextM 


1 3.0 


引数 ► 1011 良 

mTEHdl 

; マルチ フォン ト テキス ト エディッ トレ コード 
への ハン ドル 

long 

textHdl 

; 文字列への ハン ドル 

long 

length 

; 文字列の バイト 数 

long 

StyleCellHdl 

; スタイル 情報の セルへの ハン ドル 

byte 

model 

=  0  textHdl を そのまま 編集 テキスト 
じする 

丰。 textHdl を 別の ブロック に 複写 後、 
編集 テキスト にす る 

byte 

mode2 

=  0  StyleCellHdl を そのまま ス タイ 
ル 情報に する 

丰り  StyleCellHdl を另 リのフ •ロックに 
複写 後、 スタイル 情報に する 

返り 値 ►  DO.L 

リザルト コ ー ド 

機能 mTEHdl で 指定した テキスト エディットに textHdl と length で 指定した 
テキストを 編集 用に セットし、 styleCellHdl で 指定した スタイル 情報を 付 
加す る。 巧 表示は 斤わない。 

model, 田 ode2 に 0  U 外を ホ旨定 した 場合、 それぞれ textHdl ， styleCellHdl 
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は 疑似 ハン ドル も 可。 

再配置が 発生す る。 

C の 関数*^  int  TMSetTextMCMTEdit  **mT 拙 dl, char  **textHdl, 

long  length ,  void  **styleCellHdl , int  model , int  mode2) ; 
返り 値は リ ザル トコ ー ド。 


$A472  TMSetDefKind  FsH 


引 

数 

long 

mTEHdl 

; マルチ フォン ト テキス ト エディツ トレ コード 
への ハン ドル 

long 

styleRecPtr 

; ス タイ ル 情報 レコ ー ド への ポインタ 

返り 値 

DO.L 

リザルト コ ー ド 

機 

能 

皿 TEHdl 

で 指定した マルチ フォン ト テキス ト エディット レコ ー ドに、 styleRec 

Ptr で 指定した スタイル 情報を々 レントと して セッ ト する。 

最終 斤の 改斤 幅に 変更が あった 場合 （嚴終 行が 空行の 場合） は "圧 OF]" を 再 
表示す る。 

再配置が 発生す る。 

C の 関数 ►  int  TMSetDefKindmEdit  **inT 拙 dl, 咒 Style  *styleRecPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A473  TMGetStyle  I  3.G 


引 

数 

long 

mTEHdl 

; マルチ フォン ト テキス ト エディッ トレ コード 
への ハン ドル 

long 

IStyleRecPtr 

; 文字 サイズ かき スタイル 情報 レコードへの 
ポインタ 

long 

offset 

; バイ ト 位置 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

スタイル 情報 セル 中の 該当 レコー ドへの ポインタ 

機 

能- 

mTEHdl 

で 指定した マルチ フォント テキスト エディット 中の、 offset で、 ネ旨定 

した バイト 位置の スタイル 情報を IStyleRecPtr で 指定した スタイル 情報 レ 
コー ドに 格納す る。 オプション 情報は 無視され る。 

AO.L に 返る ポインタは 再配置 可能 ブロック 中への ポインタ なので、 再配置が 
発生す ると 無 劾になる。 

C の 関数 ►  int  TMGetStyle iWTEdit  **mTEHdl,  TELStyle  *lStyleRecPtr ， 
long  offset) ; 

返り 値は リ ザル トコ ー ド。 
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$A475 


TMGetStyles 


13^ 


引 数 

long 

mTEHdl 

; マルチ フォン ト テキス ト エディツ トレ コード 
への ハン ドル 

long 

styleCellHdl 

； スタイル 情報 セルが 返る 再配置 可能 ブロ ツ 

ク への ハン ドル 

long 

selStart 

； 關始 位置 

long 

selEnd 

； 終了 位置 

返り 値 

DO.L 

スタイル 情報 セルの バイト 数一 8 
い、 ザル トコ ー ド 

AO.L 

スタイル 情報 セルへの ハン ドル 

機 能 ►  mTEHdl で 指定した マルチ フォント テキスト エディットの selSt  art 〜 selEnd 
間の スタイル 情報を、 styleCellHdl で 指定した ブロックに 格納す る （ブロ ッ 
クの サイズは 調整され る）。 

S 巧 leCellHdl に 0 を 指定した 場合、 テキスト マンが ヒープ 中に 作成す る。 
再配置が 発生す る。 

C の 関数 ►  void  ^*TMGetStyles (MTEdit  **mTEHdl,  void  **styleCellHdl , 
long  selStart , long  selEnd) ; 

返り 値は スタイル 情報 セルへの ハン ドル。 

エラー が 発生した 場合、 NULL が 返る。 


$A476 


TMChangeStyle 


1 3.0 


引数- long 

long 

word 


mTEHdl 

styleRecPtr 

flags 


マルチ フォン ト テキス ト エディツ トレ コード 
への ハン ドル 

スタイル 情報 レコードへの ポインタ 
設定す る 情報を 指定す る フラグ 


bitO 

フォント カ イン ドを 設定す る 

bitl 

フォン ト フェイスを 設を する 

bit2 

X 方向の フォン ト サイ ズを 設定す る 

bits 

y 方向の フォン ト サイズを 設定す る 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ► 皿咒 Hdl で 指定した マルチ フォント テキスト エディットの セレクト 範囲に sty 
leRecPtr で 指定した スタイル 情報を 設定し、 再 表示す る。 このと き、 flags 
で ビットを 1 にした 情報に ついての み 設定が 巧 われる。 

再配置が 発生す る。 

C の 関数 ►  int  TMChangeStyleiKTEdit  **mTEHdl,  TEStyle  *styleRecPtr ， 
int  flags) ; 

返り 値は リ ザル トコ ー ド。 
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$A477  TMChangeFace 


[las' 


引 数 

long 

mTEHdl 

; マルチ フォン ト テキス ト エディッ トレ コード 
への ハン ドル 

word 

face 

； フォン ト フェイス 

word 

虹る sk 

; マスク 

返り 値 > 

DO.L 

リ ザル ト コード 

機 能 ►  mTEHdl で 指定した マルチ フォント テキスト エディットの セレクト 飯 囲に； face 
で 指定され た フォント フュ イスを 設定し、 再 表示す る。 このと き、 mask でビッ 
卜を 1 にした フォント フュ イス 情報 じついて のみ、 設定が 行われる。 
再配置が 発生す る。 

C の 関数 ►  int  TMChangeFace (MTEdi t  **mTEHdl, int  face,  int  mask) ; 
返り 値は リ ザル トコ ー ド。 


$A478 

TMSetColor 

引 数- 

long 

mTEHdl 

word 

f oreColor 

word 

backColor 

word 

aPage 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

I  3~0 


機能 I 


マルチ フ ォン ト テキスト エディツ トレ コード 
への ハン ドル 

フォア グラウン ド々 ラー 
バッ ク グラウン ド カラー 
アクセス ページ 


mTEHdl で 指定した マルチ フォント テキスト エ デット の、 デフォルトの フォ 
アグ ラウンド々 ラー、 バックグラウンド カラー、 アクセス ページを それぞれ 


foreCo 丄 or,  backCo 丄 or,  EtPa^ge  (こ 'I' る。 

再 表示は しない。 

C の 関数 ►  int  TMSetCoiorCMTEdit  **niTEHdl， int  foreColor, 


int  backColor,  int  aPage) ; 
返り 値は リ ザル トコ ー ド。 


$A479  TMSetMode 


113.0 


引 数 ► long  mTEHdl 

word  皿 ode 

word  hColor 


; マルチ フォン ト テキス ト エディツ トレ コード 
への ハン ドル 

; 描画 モード 
; 反転 文字 色 


word  exMode 


bitO 

ワー ド ブレーク 処理 

bitl 

タブ 表示 

bits 

通常は 1 
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返り 値- 


D0.L 


リ ザル ト コード 
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機 能 田咒 Hdl で 指定した マルチ フォント テキスト エディット レコードの 拡張 編集 
モードを 設定す る。 設定 後、 $A464  TMSetSelCal で 再 計算を 斤い、 $A313 
TMUpDate で 再 描画す る 必要が ある。 

C の 関数 ►  int  TMSetMode (MTEdit  **mTEHdl,int  mode , int  hColor, 
int  exMode) ; 

返り 値は リ ザル トコ ー ド。 


$A47A  TMPutScrapM  I  3.D 


引 

数- 

long 

length 

； 文字列の バイト 数 

long 

StrHdl 

; 义字 列への ハン ドル 

long 

styleCellHdl 

; スタイル 憎 報 セルへの ハン ドル 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

機 

能- 

strHdl 

で 指定した length 

バイ トの 文字列、 StyleCellHdl で 指定した 

スタイル 情報 セルを、 テキス ト マンス クラップ じ 格納す る。 
両方の ハン ドルに 疑似 ハン ドルを 使用す る ことが 可能。 
再配置が 発生す る。 


C の 関数 ►  int  TMPu tScrapM ( 1 ong  length,  char  **strHdl , 
void  **styleCellHdl) ; 

返り 値は リ ザル トコー ド。 


$A47B 

TMInsertM 

1  3.0 

引数 ► long 

mTEHdl 

； マルチ フォン ト テキス ト エディッ ト レコー ド 

への ハンドル 

long 

strPtr 

; 义字 列への ポイ ンタ 

long 

length 

； 文字列の バイト 数 

long 

StyleCellHdl 

; スタイル 情報 セルへの ハンドル 

返り 値 ►  DO.L 

リ ザル トコー ド 

機 能 ► 皿 TEHdl で 指定した マルチ フォント テキスト エディットの セレクト 領域と strPtr 
で 指定した 文字列を 置き換えて 再 表示す る。 その 際、 styleCellHdl で 指定し 
たス タイ ル 情報が 同時に 設定され る。 

再配置が 発生す る。 

C の 関数 ►  int  TMInsertMC MTEdit  **mT 拙 dl , char  *strPtr , 101 ig  length, 
void  **styleCellHdl) ; 

返り 値は リ ザル トコ ー ド。 
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$A47C  TMStrM 


引 数- 

long 

mTEHdl 

; マルチ フォン ト テキス ト エディツ ト レコ 
への ハン ドル 

long 

StrPtr 

; 义字 列への ポイ ンタ 

long 

length 

； 文字列の バイト 数 

long 

hisRecPtr 

； 編集 履歴 レコードへの ポインタ 

long 

StyleCellHdl 

; スタイル 情報 セルへの ポインタ 

返り 値 

DO.L 

リザ ノレ トコ ー ド 

0 

編集し なかった 

1 

編集した 

機 能 ► 阻 TEHdl で 指を された マルチ フォント テキスト エディット レコードの 編集 テキス 
卜の セレクト 領域を、 strPtr で 指定した 义字 列と 置き換え、 編集 履歴 レコー 
ドを 作成す る。 力ー ソル 位置の 再 計算は 斤 われない。 その 際、 styleCellHdl 
で 才旨定 した スタイル 情報が 同時に 設定され る。 C 民 （$0D)  U 外の 制御 コー ドを 
含めた 場合、 文字と して 扱われる。 再 表示は 行わない。 

再 配 罵が 発生す る。 

C の 関数 ►  int  TMS か M(MTEdit  ** 皿 TEHdl,  char  本 strPtr,  long  length, 
TEH is  *hisRecPtr,  void  **styleCellHdJJ  ; 

返り 値は、 編集 結果 またはり ザル トコ ー ド。 


$A47D  TMSetStyles 


IT^ 


引 数 ►  long  mTEHdl  ; マルチ フォント テキスト エディット レコー ド 

への ハン ドル 

long  StyleCellHdl  ; スタイル 情報 セルへの ポインタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  mTEHdl で 指定した マルチ フォント テキスト エディットの セレクト 領域に、 
StyleCellHdl で 指定した スタイル 情報を 設定し、 再 表示す る。 

再 配 蘆が 発生す る。 

C の 関数 ►  int  TMSetStyles ( MTEdi t  **mT 拙 dl, void  **styleCellHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A47E  TMGetExStyles 


弓  I  数 ► long  mTEHdl 


long  丄 StyleRecPtr 


long  offset 


; マルチ フォン ト テキス ト エディッ トレ コード 
への ハン ドル 

； 文字 サイズ 付き スタイル 情報 レコー ドへの 
ポインタ 
； バイ ト位 證 
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long  optRecPtr  ; オ フシ ヨン 情報 レコー ドへの ホ インタ 

返り 値 ►  D0.L  リザルト コード 

A0.L  スタイル 情報 セル 中の 該当 レコ ー ドへの ポイ ンタ 

機 能 皿 TEHdl で 指ました マルチ フォント テキスト エディット レコードの offset で 
指定した バイ ト 位置の スタイル 情報を 返す。 IStyleRecPtr で 指定した スタ 
イル 情報 レコードには スタイル 情報が、 optRecP む： で 指ました オプション 情 
報 レコー ドには オプ ショ ン 情報が 格納 される。 

offset に 編集 テキストの [外の 位歷を 指を すると、 カレントの スタイル 情報を 
返す。 

A0.L に 返る ポインタは 再配置 可能 ブロック 中への ポインタ なので、 再配置が 
発生す る と 無効になる。 

C の 関数 ►  int  TMGetExStylesimEdit  ** 皿 TEHdl，TELStyle  *lStyleRecPtr ， 
loner  ofiset,  TEODtion  *optRecPtr) ; 

返り 値は リ ザル トコー ド。 


$A47F 


TMGetScrap 


I  3.0 


引 

数- 

なし 

返り 値 

D0.L 

A0.L 

機 

能 

テキス 

文字列の バイト 数 

テキス ト マンス クラップへの ポイ ンタ 

テキス ト マンス クラップへの ポイ ンタを 返す。 テキス ト マンス クラップの 構造 
は U 下のと おり。 

+$00 .L デー タの バイ ト数 
+$04 .L  データへの ハン ドル 
+$08. W 格納した タスクの ID 
+ $0A.L 义字 情報への ハンドル 
C の 関数 ►  TEScrap  *  TMGetScrap  (void) ; 

返り 値は テキス ト マンス クラップへの ポイ ンタ。 


$A480 


TMGetLineWidth 


I  3.0 


引 数 ► long  t 酣 dl  ; テキスト エディット レコードへの ハンドル 

long  line  ; 斤 位置 

返り 値 ►  D0.L  斤の 幅 （ドッ ト 数）/ リザ ル トコ ー ド 

機能 ►  tEHdl で 指定した テキス ト エディットの、 line で 指定した 行の 幅 （ドット 
数） を 返す。 

C の 関数 ►  int  TMGetLineWidth (TEdit  幸* tEHdl,  long  line); 

返り 値は、 斤の 幅 または リザルト コード。 
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$A481 


TMGetLineHeight 


I  3.0 


引 数 ►  long  tEHdl  ; テキスト エディット レコー ドへの ハンドル 

long  line  ; 斤 位置 

返り 値 ►  DO.L  改行 幅 （ドッ ト 数）/ リザルト コード 

機能 ►  t 拙 dl で 指定 した テキスト エディットの、 line で 指定し た 斤の 改行 幅 （ドッ 
卜 数） を 返す。 

C の 関数 ►  int  TMGetLineHeight (TEdit  **tEHdl,  long  line) ; 

返り 値は、 な 巧 幅 または リザルト コード。 


$A482 


TMLineToHeight 


I  3.0 


; テキス ト エディツ トレ コー ドへの ハン ドル 

； 斤 位置 


弓  I  数 ►  : Long  tEHdl 

long  line 

返り 値 >  DO.L  垂直 座標 

機 能 >  t 拙 dl で 指定した テキスト エディットの、 line で 指定した 斤の 垂直 座標 （口 
ング ワード） を 返す。 

C の 関数 ►  int  TMLineToHeigh t ( TEdit  **tEHdl,  long  line) ; 

返り 値は、 垂直 座標。 


$A483 


TMAdj ust He ight 


1 3.0 


引 

数- 

long 

tEHdl  ; 

long 

y  ; 

返り 値 

DO.L 

行-位置 

AO.L 

補正 後の 垂直 座標 

機 

能 

tEHdl 

で 指定した テキス ト エディ’ 

置と 補正し た 垂直 座標を 返す。 

C の 関数 > 

int  TMAdjustHeight (TEdit  ■ 

; テキス ト エディツ トレ コー ドへの ハン ドル 

； 垂直 座標 


返り 値は 斤 位置。 


$A484 


TMChangeExStvle 


3.0 


引 数 ►  long  皿 TEHdl  ; マルチ フォント テ ネスト エディット レコード 

への ハン ドル 

long  styleRecPtr  ; スタイル 情報 レコー ドへの ポインタ 

word  flags  ; 設定す る 情報を ネ旨定 する フラグ 


414 


テキス s マン 


bitO 

フォント カ イン ドを 設定す る 

bitl 

フォン トフ ユイスを 設定す る 

bit2 

X 方向の フォン ト サイ ズを 設定す る 

bits 

y 方向の フォン ト サイズを 設定す る 

long  虹 ask  ; オプション 情報の マスク 


bitO 

巧-揃えを 設定す る 

bitl 

文字を を 設定す る 

bit2 

描 岡 モー ドを 設定す る 

bits 

文字の 高さを 設定す る 

bit4 

义字閒 ピッチを 設定す る 

bits 

改行 幅を 指定す る 

bit6 〜 7 

システム 予約 

bits 

セルを 义 字の かわり に 描 晒 

bit9 

セルを 义 字の 大きさに 描闽 （網 
掛け） 

bitlO 

セルを 义 字の 下に 描画 （下線） 

bitll 

セルを 文字の 上に 描画 （ルビ） 

bitl2 〜 15 

システム 予約 

bitl6 〜 23 

システム 予約 

bit24 

フォント々 イン ド 変更 禁止 設定 

bit25 

フォント フュイ ス 変更 禁止 設定 

bit26 

X 方向の フォント サイ ズ 変更 禁 
止 設定 

bit27 

y 方向の フォン ト サイズ 変更 禁 
止 設定 

bit28 〜 29 

システム 予約 

bitSO 

ブロ ック 単位で 表示 

bitSl 

フォント 情報の 連結 禁止 設定 

返り 値 ►  DO.L  リザルト コード 

機 能 ► 皿 TEHdl で 指定した マルチ フォント テキスト エディットの セレクト 領域に sty 
leRecPtr で 指定した スタイル 情報を 設定し、 再 表示す る。 このと き、 flags 
でビッ トを 1 に した 情報 じついて のみ 設定が 行われる。 オ プショ ン 情報は 皿 ask 
で 指定され ている て 頁 目の み 設定が 斤 われる。 

两 配置が 発生す る。 

C の 関数 ►  int  T MChangeExS tyle ( MTEd i t  ** 虹 T 拙 dl ’TEStyle  *styleRecPtr , 
int  flags , long  mask) ; 

返り 値は リ ザル トコ ー ド。 


$A485  TMAnal y z eExS t y 1 e 


La .日 


引 

数- 

long 

optRecPtr 

； オプ ショ ン 情報 レコ ー ドへの ポインタ 

long 

IStyleRecPtr 

； 文字 サイズ 付き スタイル 情報 レコードへの 
ポインタ 

返り 値 

DO.L 

リ ザル トコ ー ド 

挑 

1Bc 

能 ■- 

IStyleRecPtr で 指定した スタイル 情報の オプション 情報を、 optRecPtr 
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で 指定した オフ シヨ ン 情報 レコ ー ドに 格納す る。 

C の 関数 ►  int  TMAnalyzeExStyle (TEQpt i on  *optRecPtr ,  TELStyle 
*lStyleRecPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A486 


TMSetEditMode 


3.0 


引 数 I 


返り 値 ► 
機 能 ► 


long 

word 


t 拙 dl 
flags 


DO.L 


リザ ノレ トコ — ド 


; テキスト エディツ ト レコ、 
; 編集 モード 


ドへの ハン ドル 


bitO 

改行 コード 表示 

bitl 

怔 OF] 表示 

bit2 

コント ロ  ー ルコ ー ド を 組义字 表示 

bits 

宋 使用 

bit4 

編集 禁止 

bits 

下 揃え 

bite 

LF でな 行 

bit? 

CR で 改行 

t 拙 dl で 指定した テキスト エディ’ ソ トの 編集 モー ドを 設定す る。 設定 歡 $A464 
TMSetSelCal で 再 計算を 斤い、 $A313  TMUpDate で再揣 画する 必要が ある。 
C の 関数 ►  int  TMSetEditMode (TEdit  **tEHdl, int  f  laigs) ; 

返り 値は リ ザル トコ ー ド。 


$A487 


TMCellToFont 


3.0 


long 

cellHdl 

; セル レコ ー ド への ハンドル 

long 

styleCellHdl 

; スタイル 情報 セルへの ハン ドル 

long 

flags 

； オプション 情報 

テキス h マン 
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bitO 

巧 揃えを 設定す る 

bitl 

义 字を を設 まする 

bit2 

描画 モー ドを 設定す る 

bits 

文字の 高さを 設定す る 

bit4 

义 字間 ピッチを 設定す る 

bits 

改行 幅を 指定す る 

bit6 〜 7 

システム 予約 

bits 

セルを 文字の かわり じ 描画 

bit9 

セルを 文字の 大きさに 描画 （網 
掛け） 

bitlO 

セルを 文字の 下に 描画 （下線） 

bitll 

セルを 义 字の 上に 描画 （ルビ） 

bitl2 〜 15 

システム 予約 

bitl6 〜 23 

システム 予約 

bit24 

フォント々 イン ド 変更 禁止 設定 

bit25 

フォント フュイ ス 変更 禁止 設定 

bit26 

X 方向の フォン ト サイ ズ 変更 禁 
止 設定 

bit27 

y 方向の フォント サイズ 変更 禁 
止 設定 

bit28 〜 29 

システム 予約 

bitSO 

ブロック 単位で 表示 

bitSl 

フォン ト 情報の 連結 禁止 設定 

long 

SizePt 

; フォン ト サイズを 意味す る ポイント 

返り 値 ► 

D0.L 

リ ザル トコ ー ド 

A0.L 

スタイル 情報 セルへの ハン ドル 

機能 > 

cellHdl で 指 ■定 した セル レコ ー 

ドの 内容を StyleCellHdl で 指定した スタ 

イル 情報 セルに 格納す る。 このと き、 む％ S で ビットを 1 にした 情報 じつい 
ての み 設定が 巧 われる。 セルの なかの イメージ や スクリプトは sizePt で 指定 
した サイ ズ じなる。 スタイル 情報 セルと なる 再配置 可能 ブロ ックの サイズは 伸 
縮され る。 styleCellHdl として 0 を 指定す ると、 テキスト マンが ヒープ 
上に 作成す る。 

cellHdl は 疑似 ハン ドル も 可。 

再配置が 発生す る。 

C の 関数 ►  void  ** TMCeiiToFont (void  **cellHdl,  void  **styleCellHdl , 
long  flags,  LPoint  sizePt) ; 

返り 値は スタイル 情報 セルへの ハン ドル。 

エラーが 発生した 場合、 NULL が 返る。 


$A488  TMScaleSet 


Eao 


引 数 ► long  皿  TEHdl 

word  scaleX 


； マルチ フォン ト テキス ト エディツ ト レコード 
への ハン ドル 

;x 方向の 倍率 （固定 小数点 数） 
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word  scaleY  ;y 方向の 倍率 （固定 小数点 数） 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  mTEHdl で 指定した マルチ フォント テキスト エディットの 表示 倍率を scaleX, 
scaleY で 指定す る。 ビュ ーレク タング ルり^ 外の 座標 デー タが 抵大 / 縮小され 
る。 

scaleX,  scaleY で 使用す る 固定 小数点 数は、 整数 部 6 ビット、 小数 部 10 
ビット （つまり、 倍率を 1024 倍した 数を 指定す る）。 

再配置が 発生す る。 

C の 関数 ►  int  TMScaleSetiKTEdit  **inTEHdl,  LPoint  scale); 

scale は、 scaleX と scaleY を 組み合わせた LPoint。 

返り 値は リ ザル トコ ー ド。 


$A489  TMScaleStyles 


CK6 


引 

数- 

long 

mTEHdl 

; マルチ フォン ト テキス トエ デイ ッ ト レコード 
への ハン ドル 

long 

sStyleCellHdl 

; スタイル 情報 セルへの ハンドル 

word 

scaleX 

;x 方向の 倍率 （固定 小数点 数） 

word 

sc る丄 eY 

;y 方向の 倍率 （固を 小数点 数） 

long 

dStyleCellHdl 

; 結果が 返る スタイル 情報 セルへの ハンドル 

返り 値 > 

DO.L 

リ ザル トコー ド 

AO.L 

スタイル 情報 セルへの ハン ドル 

機 

能- 

sStyleCellHdl で 指定した スタイル 情報 セルの 1 巧容 を、 scaleX,  scaleY 

で 指定した 倍率に 伸縮し、 その 結果を dStyleCellHdl で 指定され た メモリ 
ブロックに 格納す る。 メモリ ブロックの サイズは 伸縮され る。 dStyleCellHdl 
として 0 を 指定す ると、 テキスト マンが ヒープ 上に 作成す る。 
sStyleCellHdl と dStyleCellHdl じは 同一の ハンドルを 指定で きる。 
sStyleCellHdl は 疑似 ハンドル も 可。 

scaleX,  scaleY で 使用す る 固定 小数点 数は、 整数 部 6 ビット、 小数 部 10 
ビット （つまり、 倍率を 1024 倍した 数を 指定す る）。 

巧 配置が 発生す る。 

C の 関数 ►  void  ** TMScaieStyies (MTEdit  **inTEHdl,  void 

幸 幸 sStyleCellH 过 1 , LPoint  scale ,  void  幸 幸 dStyleCellHdl) ; 
scale は、 scaleX と scaleY を 組み合わせた LPoint。 

返り 値は スタ イ ル 情報 セルへの ハン ドル。 

エラー が 発生した 場合、 NULL が 返る。 


$A48A  TMBundleExStyle 
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; オプ シヨ ン 情報 レコー ドへの ポインタ 
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Ion 呂 

IStyleRecPtr 

； 文字 サイズ 付き スタイル 情報 レコードへの 
ポインタ 

返り 値 ►  DO.L 

リ ザル トコ ー ド 

機 能 ►  optRecPtr で 指定した オプション 情報を スタイル 情報に 変換し、 IStyleRecPtr 
で 指定し たバ ッ ファ じ 格納す る 〇ノく ツフア じ は 十分な 領域 を 用意す る 必要が ある。 
C の 関数 ►  int  TMB undleExStyle ( TEOpt i on  *optRecPtr ,  TELStyle 
*lStyleRecPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A4 純  TMSetLineHeight 


113.0 


引 数 ►  long  tEHdl  ; テキスト エディット レコードへの ハンドル 

word  height  ; な 行 幅 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  t 拙 dl で 指定した テキスト エディット 全体の 改行 幅を height じ 設定す る。 

設定 後、 $A464  TMSetSelCal で 再 計算を 斤い、 $A313  TMUpDate で 再 描画 
する 必要が ある。 

C の 関数 ►  int  TMSetLineHeight (TEdit  **tEHdl,  int  height) ; 

返り 値は リ ザル トコー ド。 


$A48C  TMSetTabSize 


Us 方 


引 数 ► Ion 良  t 拙 dl  ; テキスト エディット レコードへの ハンドル 

word  tabSize  ; タブの ドッ ト数 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  t 邸 dl で 指定した テキスト エディットの タブの 幅を tabSize に 設定す る。 設 
定徐 $A464  TMSetSelCal で 再 計算を 行い、 $A313  TMUpDate で 再 描画す 
る 必要が ある。 

C の 関数 ►  int  TMSet TabSize ( TEdit  **1: 拙 dl,  int  tabSize) ; 

返り 値は リ ザル トコ ー ド。 


$A48D 

TMGetStr 

1  3.0 

引 数 ► long 

tEHdl  ; 

テキスト エディッ トレ コー ドへの ハン ドル 

Ion 居 

buffPtr  ; 

バッファへの ポイ ンタ 

long 

startOf f set  ; 

關始 位置 

long 

endOf f set  ; 

終了 位置 

返り 値 ►  DO.L 

文字列の バイト 数/り ザル トコ ー ド 

AO.L 

文字列の 終端の アドレス +1 
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機 能 ►  t 邸 dl で 指定した テキスト エディットの、 startOffset 〜 endOffset の 
編集 テキストを buffPtr じ 格納す る。 テキストが キャッシュ 中に ある 場合、 
直接 キャッシュ から 転送す るので、 フラッシュ する 必要は ない。 

C の 関数 ►  int  TMGetStr (TEdit  **tEHdl,  char  *buffPtr , 
long  startOffset,  long  endOiiset) ; 

返リ 値は、 文字列の バイ ト数 または リザルト コード。 


$A48E 

TMScalePtSet 

1  3.0 

引 数- 

long 

mTEHdl 

; マルチ フォン ト テキス ト エディッ トレ コード 

への ハン ドル 

long 

pt 

； ポイント 

返り 値 

DO.L 

変換 後の ポイント 

機能 ►  pt で 指定 した ポイントを、 扭了 拙 dl で 指定 した マルチ フォ ント テキスト エディツ 
卜 の 表示 倍率 にあわせて 変換す る。 

C の 関数 ►LPoint  TMScalePtSet (MTEdit  **mTEHdl,  LPoint  pt) ; 

返り 値は 変換 後の ポイント。 


$A48F 

TMScalePtReSet 

1  3.0 

引 数- 

long 

m  咒  Hdl 

； マルチ フ オン ト テキスト エディツ トレ コード 

への ハン ドル 

long 

pt 

； ポイント 

返り 値 

DO.L 

ポイント 

機 能 ►  $A48E  TMScalePtSet によって 変換した ポイントを 元に 戻す。 

C の 関数 ►  LPoint  TMScalePtReSet (MTEdit  **mT 拙 dl,  LPoint  pt) ; 
返り 値は ポイント。 


$A490 

TMGetDefKind 

1  3.0 

引 数- 

long 

mTEHdl 

; マルチ フォン ト テキス ト エディッ ト レコー ド 

への ハン ドル 

long 

IStyleRecPtr 

； 文字 サイズ 付き スタイル 情報 レコー ドへの 

ポインタ 

返り 値 

DO.L 

リザ ノレ トコ ー ド 

AO.L 

スタイル 情報 セル 中の 該当 レコ ー ドへの ポイ ンタ 

機能 > 

mTEHdl で 指定した マルチ フォン ト テキス ト エディツ トの 々レントの スタイル 

情報を IStyleRecPtr で 指定した バッファ じ 格納す る。 オプション 情報は 無 
視 される。 

AO.L に 返る ポインタは 再配置 可能 ブロック 中への ポインタ なので、 再配置が 
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発生す ると 無効 になる。 

再配置が 発生す る。 

C の 関数 ►  int  TMGetDefKindimEdit  **mTEHdl， 
TELStyle  *lStyleRecPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A494  TMVer 


巧. 1 


引 数 なし 

返り 値 ►  DO.L  テキスト マンの バージョン 

機 能 ►  テキスト マンの バージョンを 返す。 SX-WINDOWver.3.1 の テキスト マンでは、 
返り 値は 0x0302 となる。 

SX-WINDOW  ver. 3.01 な 前では 使用す る ことができない。 

C の 関数 ►  iirt  TMVer(void) ; 

返り 値は テキス ト マンの バージョン。 


$A495  TMSetPage 


引 数 ►  long  皿 TEHdl  ; マルチ フ ォン ト テキス ト エディ ッ ト レコ ー ド 

への ハン ドル 

word  page  ;1 ぺージ の サイズ 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ► 皿 TEHdl で 指定した テキスト エディットの 1 ぺージ の サイズを page で 指定し 
たドッ ト 数に する。 

再配置が 発生す る。 

C の 関数 ►  int  TMSetPage (MTEdit  **mT 酣 dl, short  paige) ; 

返り 値は リ ザル トコ ー ド。 


$A496  TMHeightToPage 


L3.1 


引 数- 


返り 値 ► 


機能 > 


long  mTEHdl  ; マルチ フォント テキスト エディット レコード 

への ハン ドル 

long  height  ; 垂直 座標 

D0.L  ペー ジ位證 / リ ザル トコ ー ド 

A0.L  ペー ジ 情報への ポインタ 

mTEHdl で 指定した テキスト エディットに ついて、 垂直 座標 height で 指定し 
た 位置に 関する ページ 情報を 返す。 

A0.L じ 返る ポインタは 再配置 可能 ブロック 中への ポインタ なので、 再配置が 
発生す る と 無効になる。 
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ペー ジ 情報の 構造は の《 下の とおり。 


typedef  struct  { 
long 
long 
long 
long 

}  TEPage ; 


height ; 
line ; 

0 む set ; 
oheight ; 


/* 垂直 座標*/ 

/* 行 位置*/ 

/* バイ ト 位置*/ 

/* 垂直 座標 （100% 表示 時）*/ 


C の 関数 ►  int  TMHeightToPage (MTEdi t  **mTEHdl, int  height, 
TEPage  本 幸 pinfo) ; 

結果は、 TEPage 型の ポインタ pinfo に 格納され る。 

返り 値は ページ 位置 または リザ ル トコ ー ド。 


$A497  TMOffsetToPage 


巧.*! 


引 

数- 

1011 良 

皿 TEHdl  ; マルチ フォン ト テキス ト エディット レコード 

への ハン ドル 

long 

offset  ; バイ ト 位置 

返り 値 ► 

D0.L 

ぺ ー ジ 位置/ リザ ノレ トコ ー ド 

A0.L 

ページ 情報への ポインタ 

機 

能- 

皿 TEHdl 

で 指定した テ ネスト エディ ッ ト じついて、 offset で 指定した バイト 

位置に 関する ペー ジ 情報 を 返す。 

A0.L に 返る ポインタは 再配置 可能 ブロック 中への ポインタ なので、 再配置が 
発生す ると 無効になる。 

C の 関数 ►  int  TMOfFsetToPage(KTEd±t  **mTEHdl,  int  offset, 

TEPage  幸 幸 pinfo) ; 

結果は、 T 卧％ e 型の ポインタ pinfo に 格納され る。 

返り 値は ぺー ジ 位置 または リ ザル トコ ー ド。 


$A498  TMPageToLine 


面 


引 

数 ► long 

mTEHdl  ; 

マルチ フォン ト テキス トエ デイ ッ トレ コード 

への ハン ドル 

long 

page  ； 

ペー ジ 位置 

返り 値 D0.L 

A0.L 

斤 位置/ リ ザル トコ ー ド 
ページ 情報への ポイ ンタ 

機 

自卜  mTEHdl 

で 指定した テキス ト エディ 

•ット について、 page で 指定した ページ 位 

置の 斤 位置と ペー ジ 情報を 返す。 

A0.L じ 返る ポインタは 再配置 可能 ブロック 中への ポインタ なので、 再呂日 置が 
発生す ると 無効になる。 

C の 関数 ►  int  TMPageToLine (MTEdit  幸* mTEHdl,  int  page, 
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結果は、 TEPage 型の ポインタ pinfo じ 格納され る。 
返り 値は 行 位置 または リ ザル トコ ー ド。 
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$A499 


TMLineToPage 


I  3.1 


引 

数 

long 

long 

返り 値 

DO.L 

AO.L 

機 

能 

皿 TEHdl 

皿 TEHdl  ; マルチ フォント テキス ト エディツ ト レコード 

への ハン ドル 

line  ; 行 位置 

ぺ ー ジ位證 / リザ ノレ トコ ー ド 
ページ 情報への ポイ ンタ 

皿 TEHdl で 指定した テキスト エディット じついて、 line で 指定した 巧 位置の 
ペー ジ 位置と ぺー ジ 情報を 返す。 

A0.L に 返る ポインタは 再配置 可能 ブロック 中への ポインタ なので、 再配置が 
発生す ると 無効になる。 

C の 関数 ►  int  TMLineToPage (MTEdit  **inTEHdl, int  line , 

TEPage  **pinf o) ; 

結果は、 TEPage 型の ポインタ pinfo に 格納され る。 

返り 値は ページ 位置 またはり ザル トコ ー ド。 


$A49A 

TMTextWidthS 

1  3.1 

引 数 ► 

long 

mTEHdl 

； マルチ フォント テキス トエ デイ ッ トレ コード 
への ハン ドル 

long 

strPtr 

； 文字列への ポインタ 

long 

offset 

； 文字列の オフセット 

word 

length 

； 义字 列の バイト 数 

word 

StartPoint 

; 文字列の ローカル 座標-- ディ ステ ネー ショ 
ンレク タング ルの 水平 方向 オフセット 

返り 値 ► 

DO.L 

文字列の 占める 幅 （ド 

ッ ト 数）/ リザ ル トコ ー ド 

機 能 >  mTEHdl で 指定した マルチ フォント テキスト エディット レコー ドの 環境 下で、 
startPoint で ネ旨定 した 位置から strPtr,  offset,  length て •指定され 
る 文字列を 描画す る 場合、 それが 占める 幅 （ドッ ト 数） を 計算し、 結果を 返す。 
お大 / 縮小 表示を している 場合で も 100% 時の 幅を 返す。 

再配置が 発生す る。 

C の 関数 ►  int  TMText Widths (WYEdlt  本本 田 TEHdl,  const  char  本 strPtr, 
long  offet,  int  length,  int  startPoint); 

返り 値は、 文字列の 占める 幅 または リザ ル ト コード。 
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$A49B  TMLineToRHeight  dZ 


引 

数 

long 

mTEHdl 

; マルチ フォン ト テキス ト エディツ 
への ハン ドル 

ト レコ ー ド 

long 

line 

； 斤 位置 

返り 値 

DO.L 

垂直 座標 （ロング ヮー 

K) 

機 

能 

mTEHdl 

で 指定した マルチ フォン トテ ネス ト エディ ッ ト じついて、 

line で 指 

定 した 行 位置の 垂直 座標を 返す。 

拡大/縮小 表示を している 場合で も 100% 時の 幅を 返す。 
あらかじめ、 $A495  TMSetPage を 実行して おく 必要が ある。 
再配置が 発生す る。 

C の 関数 ►  int  TMLineToRHeight (MTEdit  **mTEHdl， long  line) ; 
返り 値は 垂直 座標。 


$A49D  TMGe t L ineRHe i ght  I  3.1 


引 

数- 

long 

mTEHdl 

; マルチ フォン ト テキス ト エディツ トレ コード 
への ハン ドル 

1 on 長 

line 

； 斤 位置 

返り 値 ► 

DO.L 

改行 幅 （ドッ 

卜 数）/ リ ザル トコ ー ド 

機 

能- 

mTEHdl 

で 指定した マルチ フォント テキスト エディットに ついて、 line で 指 

定 した 斤 位置の な 斤 幅を 返す。 

お大 / 縮小 表示を している 場合で も 100% 時の 幅を 返す。 

あらかじめ、 $A495  TMSetPage を 実 斤して おく 必要が ある。 

C の 関数 ►  int  TMGetLineRHeight (MTEdit  幸* mTEHdl,  long  line) ; 
返り 値は 改斤幅 または リ ザル トコ ー ド。 
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タスク 7 ン 


#include  <TASK.H> 


$A34C  TSInitTsk 


引 数- 


返り 値 ► 


機 能 ► 


long  皿 emStart 

loner  meniEnd 

loner  patnPtr 

byte  model 

byte  皿 ode2 

word  ver 


; ヒーフ 。ゾ ーン 先頭 ア ドレス 
; ヒープ ゾーン 終了 ア ドレス 
; 々レント パスを 示す 文字列 （ASCIIZ 型） 
への ポイ ンタ 

; シて ルの リリ ー ス 番号 （1 〜） 

; システム リソース ヒープ ゾーン 作成 フラグ 


0 

作成し ない 

0 

作成す る 

; シェルの バージョン 


D0.L  ヒープ ゾーンへの ポイ ンタ 

い) ザル トコー ド 

A0.L  システム リ ソース マップへの ハン ドル 

皿 e 皿 Start から memEnd までの メモ リの 先頭の 領域を タスク マン 用 ワークと し 


て 初期化し、 残りを ヒープ ゾーンと して メモリ マンで 初期化す る。 mode2 と 
して 0 じ I 外を 指定した 場合は、 システム リソース 用の ヒープ ゾーンを 作成し、 
そこに システム リソース （‘SYSTEM. LB’） をす ベて 読み込んだ あと、 あらため 
てもう 1 つ ヒープ ゾーン を 作成す る。 システム リソースは path で 指定した 
パスから 検索を 開始す る。 path は 0 を 指定す る ことで 省略で きる。 

ヒープ ゾーン 作成 後、 画面 モードを 初期化して、 すべての マネージャを 初期化 


する。 

C  の 関数 ►  Heap  *  TS J 打  it  Tsic(  VO  id  *  阻  emStart,  void  *memEnd, 


const  char  *pathPtr ,  int  model, int  皿 ode2,  int  ver, 

Handle  幸 sysRes) ; 

返り 値は ヒープ ゾーン への ポインタ。 ハンドル sysRes には システム リソー 
スマップへの ハン ドルが 返る。 


$A34E  TSInitCrtM 


引 数 なし 

返り 値 DO.L  前の 画面 モード （IOCS の CTRMOD の 値と 同等） 

い、 ザル トコー ド 

機 能 画面 モードを 初期化す る。 S 民 AM の SX-WINDOW 用 ワークが 初期化され てい 
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ない 場合、 初期化す る。 

再配置が 発生す る。 

C の 関数 ►  int  TSInitCrtM (void) ; 

返り 値は 前の 画面 モード、 または リザルト コード。 


$A34F 

TSTiniCrtM 

引 数- 

word 

虹 ode 

; 画面 モード （IOCS の CT 民 MOD の 値と 
同等） 

返り 値 

D0.L 

リザルト コ _ ド 

機 能 ► 

画面 モードを mode で 示される 値に 戻す。 

再配置が 発生す る。 

C の 関数- 

int  TayTini CrtM ( int  mode) ; 

返り 値は リ ザル トコ ー ド。 

$A351 

TSFock 

引 数- 

byte 

model 

起動 モード 1 

byte 

皿 0(ie2 

起動 モード 2 

long 

taskiD/f ilename 

ファイル 名 または タスク ID 

long 

commandPtr 

コマンド ライ ン 文字列 （LASCII 型） への 

ポインタ 

long 

environPtr 

環境への ポインタ 

long 

Type 

起動す るリ ソースの タイプ 

word 

ID 

起動す るリ ソースの ID 

返り 値 ► 

DO.L 

タスク ID/ リ ザル トコ- 

_ ピ 

機 能- 

タスクを 起動す る。 

タスク じは commandPtr で 指定 した コマン ドライ ン 文字列と、 environPtr 
で 指定した 環境が 渡される。 environPtr として 0 を 指定す ると、 タスク マ 
ンの 環境を 使用す る ことになる。 

model, 皿 ode2 の 指を じよって、 実 斤 ファイル、 リソ ース、 メモリの 3 種類 
から タスクを 起動す る こ とがで きる。 いずれも モジュールへ ッ ダが 必要で あり、 
Human68k の 実 斤 ファ イ ルな ど は サポート さ れ ない。 

再配置が 発生す る。 

•  mode2  =  0 の 場合： ファイルからの 起動 

filename で 指ました ファイルから 起動す る。 Type,  ID は 意味を 持 
たない。 

皿 odel =  0 

ファイルを ロード* 実行す る。 
model = 1 
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ファイルを ロード. 実 斤す る。 実行 終了後、 コード 領域を 開放し 
ない。 

皿 odel =  2 

ファイルを ロードす る。 実 斤は しない。 

田 odel =  3 

taskID で 指定した タスク ID で、 皿 odel =  2 で ロードした ファ 
イ ルを 実行す る。 

• 虹 ode2  = 1 の 場合： リソースからの 起動 （口ーカルリ ソース 対応） 
Type,  ID で 指定した リソースを 読み込んで 起動す る。 読み 这 まれたり 
ソースが X タイ プの実 斤 形式で あっ た 場合は リソース マ ンの 管理から 外 
される。 

皿 odel =  0 

リソースを 口ー ド • 実行す る。 

皿 odel = 1 

リソースを ロード. 実行す る。 実行 終了後、 コード 領域を 開放し 
ない。 

皿〇过 el =  2 

リソースを ロードす る。 実 斤は しない。 

皿〇过 el = づ 

taskID で 指定した タスクので、 皿 odel =  2 で ロードした リ 
ソースを 実 斤す る。 

• 皿 ode2  =  2 の 場合： メモリからの 起動 

taskID で 指定した タスク （リエント ラントで ある 必要が ある） と 同じ 
ものを、 コード 領域を 共有して 起動す る。 Type,  ID は 意味を 持たない。 
皿 odel =  0 

タスクを タ スク 管理 テーブル 上で 複写して 実 斤す る。 
model =  2 

タスクを タスク 管理 テーブル 上で 複亭 する。 実 巧は しない。 

虹 odel = づ 

taskID で 指定した タスク ID で、 皿 odel =  2 で 複写した タスク 
を 実行す る。 

C の 関数 ►  int  TSFock iint  皿 odel, int  皿 ode2,  char  幸 filename, 
const  char  *commandPtr ,  const  char  *environPtr, 
long  Type ,  int  ID); 

返り 値は タスク ID または リザ ル トコー ド。 


$A352  TSExit 


引 数 ►  long  code  ; リザルト コード 

返り 値 ►  なし （戻って こない） 
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機 能 ►  code で 指定した リザルト コードを 持って、 タスクを 終了す る。 

アプリ ケー ショ ンが 作成 した メモリ ブロック は 廃棄され ない ので、 必ず 廃棄し 
て おく 必要が ある。 

巧 配置が 発生す る。 

原則と して C 言語で 書かれた プログラムでは 使用して はならない。 


$A353 

TSFockB 

引 数- 

byte 

皿 odel 

; 起動 モード 1 

byte 

皿 ode2 

; 起動 モード 2 

long 

filename 

； ファイル 名 

long 

commandPtr 

; コマンド ライ ン 文字列 （LASCII 型） への 
ポインタ 

long 

environPtr 

; 環境への ポインタ 

long 

dFilename 

; 実際に 起動した ファイル 名が 返る バッファ 
(90 バイト） のア ドレス 

返り 値 ► 

DO.L 

タスク ID/ リ ザル トコ 

ー ド 

機 能 ►  filename で 指定した ファイル、 あるいは ビルトイン コマンドから タスクを 起 
動す る。 すでに メモリに 存在す る リエント ラントな タスクの 場合、 タスク 管理 
テ ー ブル 上で 複写して 実行す る。 

タスクには CO 匪 andPtr で 指を した コマンド ライン 文字列と、 environPtr 
で 指定した 環境が 渡される。 environPtr として 0 を 指定す ると、 タスク マ 
ンの 環境を 使用す る ことになる。 

皿 odel は $A351  TSFock と 同様な 意味を 持つ。 

皿 ode2 と して 01^ 外を 指定した 場合、 起動した （しようと した） ファイル 名を 
dFilename  じ 返す。 

filename には ワイル ド々 ー ドが 使用可能。 

再配置が 発生す る。 

C の 関数 ►  int  TSFockB (int  model , BOOLEAN  inode2 ,  const  char 

幸 壬 ilename , const  char  *cominandPtr , const  char  *environPtr , 
char  本 过 Filename ) ; 

返り 値は、 タスク ID または リザ ル トコ ー ド。 キャラクタ 型の 配列 dFilename  [90] 
には、 起動した ファイルの 名前が 返される。 


$A355  TSFockSItem 


弓 I  数 ►  long  sItemHdl  ; セ ノレ リストへの ノ 、ン ドノ レ 

返り 値 ►  D0.L  タスク ID/ リ ザル トコー ド 

機 能 ►  sItemHdl で 指定した セル リストの なかの アイコン 管理 レコー ドを 参照して、 
その すべてを 起動す る。 返り 値の タスク ID は、 最後に 起動した ものが 返る。 
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再配置が 発生す る。 

C の 関数 ►  int  TSFockSItem  (Handle  sItemHdl) ; 

返り 値は、 タスク ID または リザルト コード。 


$A356 

TSFockIcon 

引数- 

long 

ISRecPtr 

; アイコ ン 管理 レコ ー ドへの ポイ ンタ 

byte 

model 

； 起動 モード 1 

byte 

皿 ode2 

; 起動 モ ー ド 2 

Ion 良 

dFilename 

; 実際に 起動した ファイル 名が 返る バッファ 
(90 バイト） のア ドレス 

long 

command 

; コマンド ライ ン 文字列 （LASCII 型） への 
ポインタ 

返り 値 

DO.L 

タスク ID/ リ ザル トコ ー ド 

機 能 ISRecPtr で 指定した アイコン 管理 レコードを 参照して タスクを 起動す る。 
model は $A351  TSFock と 同 横の 意味を 持つ。 

皿 ode2 と して 01^ 外を 指定した 場合、 起動した （しようと した） ファイル 名と 
コマンド ラインを dFilename に 返す。 

起動時に [0PT.1] キーが 押されて いる 場合は、 cshell ウィンドウを 開いて 
ファイル 名と コマン ドライ ンの 編集を 行う。 

再配置が 発生す る。 

C の 関数 ►  int  TSFockIcon  ( IcSt  ate  *  ISRecPtr,  int  model , BOOLEAN 
mode2,  char  幸 dFi 丄 eName,  char  幸 command) ; 

返り 値は、 タスク ID または リ ザル トコ ー ド。 キャラ ク タ 型の 配列 dFilename  [90] 
には、 起動した ファイルの 名前が 返される。 


$A357  TSEvent Avail 


引 

数 

word 

eventhask 

; イ ベン ト マスク 

long 

tsEventRecPtr 

; タスク マン イベント レコ ー ドへの ポイ ンタ 

返り 値 ► 

DO.L 

リザルト コ ー ド 

機 

能- 

タスク マンの イベント キュー 

から event  Mask の 各 ビット で 指定 した イベント 

のうち、 イベント キューの なかで 嚴 初に 見つかった ものを 参照す る。 イベント 
の 内容は、 tsEventRecPtr で 指定した タスク マン イ ベン トレ コー ドに 返る。 
イベント マンの イ ベン トの ほか、 タスク マンの イベント もサ ポート される。 
この コールを 呼ぶ ことで タスクの 切り替え が 発生す る。 

再配置が 発生す る。 

C の 関数 ►  int  TSEventAvail ( int  eventMask,  TsEvent  幸 ts 巨 ventRecPtr)  j 
返り 値は リ ザル トコー ド。 
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$A358  TSGetEvent 


引 数 ►  word  eventMask  ; イベント マスク 

long  tsEventRecPtr  ; タスク マン イベント レコー ドへの ポインタ 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  タスク マンの イベント キュー から eventMask の 各 ビットで 指定した イベント 
を 取り出し、 削除す る。 取り出した イベントの 内容は、 tsEventRecPtr で 指 
定 した タスク マン イベント レコー ドに 返る。 イベント マンの イベントの ほか、 夕 
スク マンの イベント も サポート される。 

再配置が 発生す る。 

C  の 関数 ►  int  TSGetEvent  ( int  eventMask,  TsEvent  *  tsEventRecPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A35A  TSPostEventTsk 


引 数- 

long 

mesl 

メ ッセ ー ジ 1 

long 

田 es2 

メ ッセ ー ジ 2 

word 

what  2 

タスク マン イベント コード 

byte 

Hmodel 

ハン ドル モ ー ド 1 

byte 

Hmode2 

ハン ドル モード 2 

返り 値 

DO.L 

リ ザル トコー 

ド、 

機 能- 

mesl , 

皿 es2,  what 2 

で 指定し た デ ー タをそ れぞれ whom,  who 虹 2 ,  what 2 

じ 持つ よう な タスク マン イベント レコ ー ドを 作成し、 それを タスク マンの イべ 
ント キューに 登録す る。 この イベントの 種類は 12(E_SYSTEM1) に 固定。 
whom あるいは whom2 に 格納され ている 引数が ハンドル である 場合、 Hmodel 
あるいは Hmode2 に 0 じ I 外を 指定す ると、 別の ブロックを 作成して whom, 
whom2 力 《指す ブロックの 内容を コピーす る。 タスク マンの イベント キューに 登 
録 される タスク マン イ ベント レコードの who 皿， wliom2 に は 新しく 作成した 
ブロックへの ハンドルが 格納され る。 この場合、 タスク マン イベント レコード 
を 廃棄す る 際、 これらの ブロックは 同時に 廃棄され る。 

再配置が 発生す る。 

C  の閲数 ►  int  TSPostEventTsk  Cion  を  mesl , long  皿  es2,  int  what  2 , 
BOOLEAN  Hmodel,  BOOLEAN  Hmode2) ; 

返り 値は リ ザル トコ ー ド。 


$A35B  TSGetTdb 


引 数 ►  long  buffPtr  ; タスク 管理 レコー ドが 返る バッファ （512 バ 

イト） の アドレス 

word  taskID  ; タスク  ID 
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返り 値 ►  DO.L  リザ ル トコー ド 

機 能 ►  taskID で 指定した タスクの タスク 管理 テーブルの 内容を buffPtr で 指を 
した バッファに 返す。 taskID として- 1 を 指定した 場合、 この コールを 呼ん 
だ タスクの タスク 管理 レコードが 返る。 

C の 関数 ►  int  TSGetTdbdask  *buffPtr ,  int  taskID) ; 

返り 値は リ ザル トコ ー ド。 


$A35C  TSSetTdb 


引 数 ► long  buf fPtr  ; タスク 管理 レコードへの ポインタ 

word  taskID  ; タスク  ID 

返り 値 ►  D0.L  リザルト コード 

機能 ►  taskID で 指定した タスクの タスク 管理 テーブルに buf  fPtr で 指定した タス 
ク 管理 レコードの 内容を コピーす る。 taskID として- 1 を 指定した 場合、 こ 
の コールを 呼んだ タスクの タスク 管理 テーブルに コピーす る。 

C  の 関数 ►  int  TSSetTdb  (Task  *buffPtr ,  int  taskID) ; 

返り 値は リ ザル トコ ー ド。 


$A35E  TSGetWindowPos 


引 数*^ なし 

返り 値 ►  D0.L  ウィンドウを 才 ープン する ポイント （グローバル 座標） 

機 能 >  ウィンドウを オープン する ポイントを 得る。 得られた ポイントは ウィンド ウレ 
ク タング ルの 左上 座標と して 指定す る。 

C の 関数 ►  LPoint  TSGetWindowPosCvoid) ; 

返り 値は ポイント。 


$A35F 

TSCommunicate 

引 数- 

word 

listener 

； 宛先と なる タスクの ID 

long 

tsEventRecPtr 

; タスク マン イベント レコードへの ポインタ 

word 

mode 

； 返答 モード 

0  返事を 受け付けない 
1 返事を 受け付ける 


0 

正常終了 

1 

返事が 届いた 

-1 

宛先の タスクが を 在し ない 

-2 

宛先の タスクの 準備が 整って いない 

<0 

リザルト コ ー ド 

機 能 ►  listener で 指を した タスクに tsEventRecPtr で 指定した タスク マン イべ 


431 


タスク マン 


ント レコードの 内容の イベントを 発 化させる。 すなわち、 タスク マン イベント 
レコードの 内容に よって、 タスク 間 通信を 行う。 これに よって、 宛先の タスク 
に 発生す る イベントは 13(E_SYSTEM2) に 固定。 

タスク マン イベント レコードの what に 入って いる イベント コードは 意味を 持 
たない。 what  2 には メッセージの 意味を 示す コード （128 〜 32767) を、 tskid 
じは 自 かの タスク ID を 指定す る。 who 皿， whom2 じは 引数を、 when には 必 
要が あれば チック カウン トを 格納す る。 

メッセージを 送られた 側の タスクは、 返事を 返す 場合、 送られて きた タスク マ 
ン イベント レコード のなかに 返事と なる データを 格納す る。 

この コールは、 他の タスク と 通信 中の タスクに も 割り込んで メ ッ セージを 送 
る ことができる ため、 混乱す る 場合が あるので、 通常は $A418  TSSendMes, 
$A417  TSAnswer を 使用して タスク 間 通信を 斤う。 

再配置が 発生す る。 

C の 関数 ►  int  TSCommunicate ( int  listener,  TsEvent  *tsEventRecPtr , 
int  皿 ode) ; 

返り 値は 結果を 意味す る 数値。 


$A360 

TSGetID 

引 数 

なし 

返り 値 

D0.L 

タスク ID 

機 能 > 

この コ 

ー ルを 呼んだ タスクの タスク ID を 返す。 

C の 関数 ►  int  TSGetID (void) ; 

返り 値は タスク ID。 

$A361 

TSMakeEvent 

引 数 ► 

long 

mesl 

メ ッセ ー ジ 1 

long 

mes2 

メ ッ セージ 2 

word 

what  2 

タスク マン イ ベン ト コード 

byte 

Hmodel 

ハン ドル モ ー ド 1 

byte 

Hmode2 

ハン ドル モ ー ド 2 

long 

tsEventRecPtr 

タスク マン イベント レコ ー ドへの ポイ ンタ 

返り 値 ► 

DO.L 

リ ザル トコー ド 

機 能 ► 

mesl , 

皿 es2 ,  what  2 で 指定し た デー タをそ れぞれ whom,  whom2 ,  what  2 

に 持つ よ うな タスク マン イベント レコ ー ドを、 tsEventRecPtr で 指定した レ 
コー ドの なかに 作成す る。 この イベントの 種類は 12(E_SYSTEM1) じ 固定。 
who 皿 あるいは whom2 に 格納され ている 引数が ハン ドルで ある 場合、 Hmodel 
あるいは Hmode2 に 0 じ [外を 指定す ると、 別の ブロックを 作成して whom, 
who 皿 2 カタ 旨す ブロックの 内容を コピーす る。 作成され る タスク マン イベント レ 
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コードの who 皿， who 皿 2 には 新しく 作成した ブロックへの ハンドルが 格納され 
る。 

再配置が 発生す る。 

C の 関数 ►  int  TSMakeEvent ( 1 ong  皿 esl,  long  mes2,  int  what 2, 

BOOLEAN  Hmodel , BOOLEAN  Hmode2 ,  TsEvent  *tsEventRecPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A364  TSGetStartMode 


引数 ► なし 

返り 値 D0.L  =0  終了 画面を 保存し ない 
丰。  終了 画面を 保な する 
機能 ►  スタート 画面の 保存 モードを 返す。 

C  の 関数 ►  BOOLEAN  TSGetStartMode  (void) ; 

返り 値は スタート 画面の 保存 モード。 


$A365  TSSetStartMode 


引 数 ►  word  皿 ode  ; スタート 画面の 保存 モード 

=0  終了 画面を 保存し ない 

丰り  終了 画面を 保存す る 

返り 値 ►  なし 

機能 ►  スタート 画面の 保存 モードを mode に 設定す る。 

C  の 関数 ►  void  TSSetStartMode  (int  mode) ; 

返り 値は ない。 


$A367  TSOpen 


引 数 ► long  namePtr  ; ファイル 名への ポインタ （ASCIIZ 型） 

word  皿 ode  ; アクセス モード 

返り 値 ►  D0.L  ファイル ハンドル/リザルト コード 

機 能 ►  namePtr で ネ旨定 した 名前の ファイルを、 mode の アクセス モー ドで 才ー プンす 
る。 DOS コー ルの $FF3D  OPEN と 同様の 動作を 斤う。 

再配置が 発生す る。 

お 張され ている 点は 次のと おり。 

• ク リーナに 対応して いる 

ファイル 名が ク リーナ じ 含まれる ときは オープンで きない。 

• タスク マンの イベントが 発を する 
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20( 日 PENFILE、 "ファイルの 才ープ ン"） と IGCCREATFILE、 "フ ァイ 
ルの 作成’’） のど ちらか、 または 両方が 発生す る。 

C の 関数 ►  int  TSOpen (const  char  *nainePtr ,  int  mode) ; 

返り 値は、 ファイル ハン ドル または リザ ル ト コード。 


$A368  TSClose 


引 数 ►  word  f ilelD  ; ファイル ハンドル 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  filelD で 指定され た ファイルを クローズ する。 DOS コールの $FF3E  CLOSE 
と 同様の 動作を 行う。 

再 配 鼠が 発生す る。 

拡張され ている 点は 次の とおり。 

• タスク マンの イベントが 発生す る 

21(CL0SEFILE、 "ファイルの クローズ"） が 発生す る。 

C  の 関数 ►  int  TSClose  dint  f  ilelD) ; 

返り 値は リ ザル トコード。 


$A369  TSRmDirH 


引 数 ► long  nameHdl  ; デイ レクト リ 名への ハンドル （ASCIIZ 型） 

返り 値 D0.L  リザ ル トコー ド 

機能 ►  nameHdl で 指定した ディ レクト リ を 削除す る。 DOS コー ルの $FF3A  RMDIR 
と 同様の 動作を 斤う。 ディ レクト リ 名は 必ず フルパスで 指定す る 必要が ある。 
再配置が 発生す る。 

お 張され ている 点は 次のと おリ。 

• ク リーナに が応 している 
• タスク マンの イベントが 発生す る 

lOCRMDIR. "ディ レクト リの 削除"） が 発生す る。 

C の 関数 ►  int  TSRmDirH ( char  **naineHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A36A 

TSCopyH 

引 数 

long 

sNameHdl 

; コピー 元の ファイル 名への ハンドル 

(ASCIIZ  型） 

long 

dNameHdl 

; コピー 先の ファイル 名への ハンドル 

(ASCIIZ  型） 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 
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機能 ►  sNameHdl で 指定 した ファイルを、 dNameHdl で 指定 した ファイルに コピー す 
る。 ファイル 名は 必ず フ ル パス で 指定す る 必要が ある。 

コピー が 正常に 終了した 場合、 タスク マン イベント 14(C0PYFILE、 。ファイル 
のコ ピー"） が 発生す る。 

コ ピー 先 ファイルが クリ ーナじ 含まれる 場合は クリ ーナが フラッ シュ される。 
再配置が 発生す る。 

C の 関数 ►  int  TSCopyH ( char  幸* sNameHdl,  char  **dNameHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A36B  TSMkDirH 


引 数 ►  long  nameHdl  ; ディ レクト リ 名への ハン ドル （ASCIIZ 型） 

返り 値 ►  D0.L  リザ ル トコー ド 

機能 ►  nameHdl で 指定した ディ レクト リ を 作成す る。 DOS コールの $FF39  MKDIR 
と 同様の 動作を 斤う。 ディ レクト リ 名は 必ず フルパスで 指定す る 必要が ある。 
再配置が 発生す る。 

拡張され ている 点は 次のと おり。 

• ク リーナに 対応して いる 

ディ レクト リ 名が ク リーナに 含まれる 場合は ク リーナが フラッシュ される。 
• タスク マンの イ ベン トが 発生す る 

15(MKDIR、 "ディ レクト リの 作成"） が 発生す る。 

C の 関数 ►  int  TSMkDirH ( chax  **naineHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A36C 

TSMoveH 

引 数 

long 

sNameHdl 

; 移動 元の ファイル 名への ハンドル (ASCIIZ 
型） 

long 

dNameHdl 

； 移動 先の ファイル 名への ハンドル (ASCIIZ 
型） 

返り 値 

DO.L 

リ ザル トコ ー ド 

機能 ►  sNameHdl で 指定した ファイルを、 dNameHdl で 指定した ファイル じ 移動す る。 

DOS コー ルの $FF56  RENAME と 同様の 動作を 巧う。 同じ パス じある ファイル 
の 場合、 リネーム する。 ファイル 名は 必ず フルパスで 指定す る 必要が ある。 
正常に 終了した 場合、 タスク マン イベント 13 (MOVEFILE. "ファイルの 移動"） 
が 発生す る。 

移動 先 ファイルが クリ ーナに 含まれる 場合は クリ ーナが フラッ シュ される。 
再配置が 発生す る。 

C の 関数 ►  int  TSMoveH ( char  **sNameHdl , char  dNameHdl) ; 

返リ 値は リ ザル ト コード。 
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$A36D  TSCreate 


引 数 ► long  namePtr  ; ファイル 名への ポインタ （ASCIIZ 型） 

word  atr  ; アトリビュート 

返り 値 ►  D0.L  ファイル ハン ドル/リザ ル トコー ド 

機能 ►  namePtr で 指ました 名前の ファイルを、 atr の アト リビュ ートで 新規 作成す 
る。 DOS コールの $FF3C  CREATE と 同様の 動作を 斤う。 

再配置が 発生す る。 

抱 張され ている 点 は 次のと おり。 

• ク リーナに 対応して いる 

ファイル 名が クリ ーナに 含まれる ときは クリ ーナが フラッ シュ される。 

• タスク マンの イベントが 発生す る 

16(CREATFILE、 "ファイルの 作成"） が 発生す る。 

C  の 関数 ►  int  TSCreate  (const  char  *namePtr ,  int  atr); 

返り 値は ファイル ハン ドル または リザ ル ト コード。 


$A36E  TSDeleteH 


引 数 ► long  nameHdl  ; ファイル 名への ハンドル （ASCIIZ 型） 

返り 値 ►  DO.L  リザ ル トコード 

機 能 ►  nameHdl で 指定した ファイルを 実際に 削除す る。 DOS コールの $FF41  DELETE 
と 同様の 動作 を 行-う。 ファイル 名 は 必ず フ ル パス で 指定す る 必要が ある。 
再配置が 発生す る。 

が: 張され ている 点は 次のと おり。 

• ク リーナに 対応して いる 
• タスク マンの イベントが 発生す る 

lUDELETEFILE、 "ファイルの 削除"） が 発生す る。 

C の 関数 ►  int  TSDeleteH ( char  **nameHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A36F 

TSTrash 

引 数- 

long 

sNameHdl 

; 移動 元の ファイル 名への ハン ドル (ASCIIZ 
型） 

long 

dNameHdl 

; 移動 先の ファイル 名への ハンドル (ASCIIZ 

型） 

返り 値 > 

DO.L 

リ ザル トコー ド 

機能 sNameHdl で 指定した ファイルを、 dNameHdl で 指定した ファイルに 移動す 
る。 ク リーナ から、 または ク リーナへの 移動を 斤い、 実際に ファイルが 移動 さ 
れる わけでは ない。 ファ イ ル 名は 必ず フルパスで 指定す る 必要が ある。 
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正常に 終了した 場合、 タスク マン イベント 13 (MOVEFILE、 "ファイルの 移動"） 
が 発生す る。 

再配置が 発生す る。 

C の 関数 ►  int  TSTrashichar  **sNameHdl , char  **dNaineHdl) ; 

返り 値は リ ザル トコー ド。 


$A370  TSFiles 


引 

数- 

long 

fileBuff  ; 

結果が 返る バッファの ア ドレス 

long 

namePtr  ; 

ファイル 名への ポインタ （ASCIIZ 型） 

word 

atr  ; 

ァト リビ ュート 

返り 値 

DO.L 

リ ザル トコード 

機 

能- 

namePtr 

で 指定した ファイル 名と 

atr で 指定した ア トリ ビュ ート じ 合致す 

るよう な 最初の ファイルを 探し、 その ファイルに ついての 情報を fileBuff 
に 返す。 DOS コー ルの $FF4E  FILES と 同様の 動作を 巧う。 

クリ ーナに 入って いる ことに なって いる ファイルは 検索の 対象とは ならない。 
再配置が 発生す る。 

C の 関数 ►  int  TSFiles、void  *f  ileBuff ,  const  char  *nainePtr ,  int  atr) ; 
返り 値は リ ザル トコ ー ド。 


$A371 

TSNFiles 

引 数- 

long 

fileBuff 

; 結果 力 > •返る バッファの ア ドレス 

long 

namePtr 

; ファイル 名への ポインタ （ASCIIZ 型） 

word 

atr 

; ァ トリ ビュート 

返り 値 

DO.L 

リザ ノレ トコ ー ド 

機能 ►  前回の TSFiles/TSNFiles に 続く ような ファイルを 探し、 その ファイル につ 
いての 情報を fileBuff に 返す。 DOS コールの $FF4F  NFILES と 同様の 動 
作を 斤ぅ。 

クリ ーナに 入って いる ことに なって いる ファイルは 検索の 対象とは ならない。 
TSNFiles を 呼んだ あとじ コールし、 namePtr と atr は TSNFiles と 同 
じ ものを 指定す る。 

再配置が 発生す る。 

C  の 関数 ►  int  TSNFilesCvoid  ♦fileBuff ,  const  char  *  name  Pt  r ,  int  atr) ; 
返り 値は リザルト コード。 


$A372  TSCopyP 


引 数 ►  long  sNamePtr  ; コピー 元の ファイル 名への ポインタ 

(ASCIIZ  型） 
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long  dNamePtr  ; コピー 先の ファイル 名への ポインタ 

(ASCIIZ  型） 

返り 値 ►  DO.L  リザルト コード 

機能 >  sNamePtr で 指定した ファイルを dNamePtr で 指定した ファイルに コピーす 
る。 ファ イ ル 名は 必ず フルパスで 指を する 必要が ある。 

コピーが 正常に 終了した 場合、 タスク マン イベント 14(C0PYFILE、 "ファイル 
のコ ピー"） が 発生す る。 

コ ピー 先 ファイルが クリ ーナに 含まれる 場合は クリ ーナが フラッ シュ される。 
再配置が 発生す る。 

C の 関数 ►  int  TSCopyP (const  char  *sNamePtr ,  const  char  *dNamePtr) ; 
返り 値は リ ザル トコ ー ド。 


$A373  TSDeleteP 


引 数 ► long  namePtr  ; ファイル 名への ポインタ （ASCIIZ 型） 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  namePtr で 指定した ファイルを 実際に 削除す る。 DOS コールの $FF41  DELE 咒 
と 同様の 動作 を 巧う。 ファイル 名は 必ず フ ル パス で 指定す る 必要が ある。 

巧 配置が 発生す る。 

拡張され ている 点 は 次の とおり。 

• ク リーナに 対応して いる 
• タスク マンの イベントが 発生す る 

lUDELETEFILE、 "ファイルの 削除"） が 発生す る。 

C  の 関数 ►  int  TSDeleteP  (const  char  *nainePtr) ; 

返り 値は リ ザル トコ ー ド。 


$A374  TSRmDirP 


引 数 ► long  namePtr  ; ディ レクト リ 名への ポインタ （ASCIIZ 型） 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  namePtr で 指定した ディレクトリ を 削除す る。 DOS コー ルの $FF3A  RMDIR 
と 同様の 動作を 行う。 ディ レクト リ 名は 必ず フルパスで 指定す る 必要が ある。 
巧 配置が 発生す る。 

お 張され ている 点 はかの とおり。 

• ク リーナに 対応して いる 
• タスク マンの イ ベン トが 発生す る 

10(RMDIR、 "ディ レクト リの 削除つ が 発生す る。 

C  の 関数 ►  int  TSRmDirP  (const  char  *namePtr) ; 

返り 値は リ ザル トコ ー ド。 
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$A375  TSMkDirP 


引 数 ► long  namePtr  ; デイ レクト リ 名への ポイ ンタ （ASCIIZ 型） 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機能 ►  namePtr で 指ました ディ レクト リ を 作成す る。 DOS コー ルの $FF39  MKDIR 
と 同様の 動作を 斤う。 ディ レクト リ 名は 必ず フルパスで 指定す る 必要が ある。 
再配置が 発生す る。 

お 張され ている 点 は 次の とおり。 

• ク リーナに 対応して いる 

ディ レクト リ 名が ク リーナに 含まれる 場合は、 ク リーナが フラッシュ される。 
• タスク マンの イベントが 発生す る 

15(MKDIR、 "ディ レクト りの 作成"） が 発生す る。 

C の 関数 ►  int  TSMkDirP ( const  char  *namePtr) ; 

返り 値は リザ ル トコ ー ド。 


$A376 

TSMoveP 

引 数- 

long 

sNamePtr 

; 移動 元の ファイル 名への ポインタ （ASCIIZ 
型） 

Ion 良 

dNamePtr 

; 移動 先の ファイル 名への ポインタ （ASCIIZ 
型） 

返り 値 ► 

DO.L 

リ ザル トコー ド 

機能 ►  sNamePtr で 指定した ファイルを dNamePtr で 指定した ファイル じ 移動す る。 

DOS コー ルの $FF56  RENAME と 同様の 動作を 斤う。 同じ パスに ある ファイル 
の 場合、 リネーム する。 ファイル 名は 必ず フルパスで 指定す る 必要が ある。 
正常に 終了した 場合、 タスク マン イベント 13 (MOVEFILE、 "ファイルの 移動’’） 
が 発生す る。 

移動 先 ファイルが ク リーナに 含まれる 場合は、 ク リーナが フラッシュ される。 
再配置が 発生す る。 

C の 関数 ►  int  TSMoveP ( const  char  *sNainePtr ,  const  char  *dNainePtr) ; 
返り 値は リ ザル トコ ー ド。 


$A378  TSChMod 


引 数 ►  long  namePtr  ; ファイル 名への ポインタ （ASCIIZ 型） 

word  atr  ; アト リビュ ート 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  namePtr で 指を した ファイルの アトリビュートを atr に 変更す る。 ファ イ 
ル 名は 必ず フルパスで 指定す る 必要が ある。 

正常に 終了した 場合、 タスク マン イベント 22(CHM0DFILE、 "ファイルの 移動"） 
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が 発生す る。 

再配置が 発生す る。 

C の 関数 ►  int  TSChMod ( const  char  *namePtr ,  int  atr) ; 
返り 値は リ ザル トコー ド。 


$A379  TSWhatFile 


引 数 ► long  tsEventRecPtr  ; タスク マン イベント レコー ドへの ポインタ 

long  namePtr  ; ファイル 名への ポインタ （ASCIIZ 型） 

返り 値 ►  D0.L  上位 ワード 


上位 バイト 

0 

ソース 側 

1 

デイ ス テイ ネー シヨ ン侧 

下位 バイト 

0 

namePtr に対して 

1 

namePtr を 含む パスに がして 

2 

namePtr じ 含まれる ファイル にがして 

4 

namePtr じ 含まれる サブ ディ レクト リ 内の ファイル に対して 

下位 ワード 


0 

無閒係 

1 

削除され る 

2 

削除され た 

3 

移動した 

4 

イ ジュク ト され^る 

5 

イ ジ 卫クト された 

6 

変更が あった (Create も 含む） 

7 

オープン された 

8 

クローズ された 

9 

指定した パスの クローズ 

10 

ボリ ューム 名の 削除 

11 

ボリ ュ ー ム 名の 作成 

機 能 ►  tsEventRecPtr で 指を した タスク マン イ ベント の 内容が、 namePtr で 指定 
した ファイル に 関係が あ るか どうかを 調べる。 ファイル 名 は 必ず フルパス で 指 
定 する 必要が ある。 

対応す る タスク マン イベントは 3(N0TICEEJECT、 "ディスク イジ ェク トの予 
告 ’’） 〜 30 (CLOSE. "指定した パスの クローズ’’）、 51 (EMPTYTRASH. "ク リー 
ナの フラッ シュ ’’）。 

C の 関数 ► long  TSWhatFile (TsEvent  TsEventRecPtr, 
const  char  *namePtr) ; 

返り 値は 結果 を 意味す る 数値。 
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$A37B  TSDeleteVoname 


引 数 ►  long  namePtr  ; ボリ ューム 名への ポインタ （ASCIIZ 型） 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  nameP れで 指定した ボリ ューム 名を 削除す る。 必ず フルパスで 指定す る 必要 
が ある。 

正常に 終了した 場合、 タスク マン イベント 12(DELETEV0NAME、 "ボリ ューム 
名の 削除"） が 発生す る。 

再配置が 発生す る。 

C  の 関数 ►  int  TSDeleteVoname  (const  char  *namePtr) ; 

返り 値は リ ザル ト コード。 


$A37C  TSCreateVoname 


引 数 ► long  namePtr  ; ボリューム 名への ポインタ （ASCIIZ 型） 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  namePtr で 指定した ボリ ューム 名を 作成す る。 必ず フルパスで 指を する 必要 
が ある。 

正常に 終了した 場合、 タスク マン イベント 17(CREATEV0NAME、 "ボリ ューム 
名の 作成"） が 発生す る。 

再配置が 発生す る。 

C  の 関数 ►  int  TSCreateVoname  (const  char  *namePtr) ; 


$A381  TSSearchFileND 


引 数- 


返り 値 ► 
機能- 


long  sNamePtr  ; ファイル 名への ポインタ （ASCIIZ 型） 

long  dNamePtr  ; 発見した ファイルの 名前 か谁る バッファ （90 

バイト） のア ドレス 

long  path  ; パス 名への ポインタ （ASCIIZ 型） 

D0.L  ファイル サイ ス V リザ ル トコ— ド 

sNamePtr で 指定した フ ァイ ルを 検索し、 発見で きた ファ イ ルの 名前を dNamePtr 
じ 返す。 検索は、 sNamePtr のなかに パスが 含まれる 場合は その パスから、 そ 
うでない 場合は path で 指ました パスから 開始す る。 そこで 見つからなかった 
場合は、 ドライブ A の ルー ト ディ レクト りから 順に 検索して いく。 

検索 中の ダイア ロ グは 表示し ない。 


dNamePtr は sNamePtr と 同じ ものを ホ旨定 しても よい。 


巧 配置が 発生す る。 


C の 関数 ►  int  TSSearchFileND ( const  char  *sNainePtr ,  char  *dNainePtr , 


const  char  幸 path) ; 

返り 値は ファイル サイ ズ または リザ ル トコ ー ド。 
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$A386  TSGetOpen 


引数 なし 

返り 値 ►  DO.L  オープン 中の ファイル 数/リザルト コード 

AO.L  オープン ファイル 名 管理 レコ ー ドの 配列への ハンドル 

機 能 ►  現在 才ー プン 中の ファイル 数と、 才 ープン ファイル 名 管理 レコードの 配列への 
ハン ドルを 返す。 

C の 関数 ►  int  TSGetOpen (OpenF ile  ***openFileList) ; 

返り 値は、 オープン 中の ファイル 数 または リザ ル トコ ー ド。 

DpenFile 型の ハンドル openFileList じは、 オープン ファイル 名 管理 レ 
コー ドの 配列への ハン ドルが 格納され る。 


$A387  TSZeroDrag 


引数- なし 

返り 値 ►  D0.L  リザルト コード 
機 能 ►  ドラッグ バッファの 内容を クリアす る。 
再配置が 発生す る。 

C の 関数 ►  int  TSZeroDragivoid) ; 

返り 値は リザルト コード。 


$A388  TSPutDrag 


引 

数 ► long 

celLength 

; セル リス トの サイズ 

long 

celHdl 

; セル リス ト への ハン ドル 

返り 値 ►  DO.L 

リ ザル トコ ー ド 

機 

肖 ドラ ッ 

グ バッファ じ celHdl 

で 指ました celLength の サイズの セル リス 

を 追加す る。 

疑似 ハン ドル も 可。 

再配置が 発生す る。 

C の 関数 ►  int  TSPutDragClong  celLength,  Handle  celHdl) ; 
返り 値は リ ザル トコ ー ド。 


$A389  TSGetDrag 


引 数- なし 
返り 値 ►  DO.L 

AO.L 


=  0  正常終了 

0  ドラッグ データがない 

ドラッグ レコ ー ドへの ポイ ンタ 
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機能 ►  システム のの ドラッグ レコードへの ポイ ンタを 返す。 

C の 関数 ►  int  TSGetDragCDrag  **drag) ; 

返り 値は 結果を 意味す る 数値。 

Drag 型の ポインタ drag じは、 ドラッグ レコードへの ポインタが 格納され る。 


$A38A  TSBeginDrag 


引 

数 ► long 

pt 

； ドラッグを 觸始 する ポイント （グローバル 
座標） 

返り 値 ►  D0.L 

リザルト コ ー ド 

機 

能 ►  pt で 指定した 位置から ドラ 

ッグを 關始 する。 ビット イメージの データが 作成 

される。 

あらかじめ、 グラフ ポートを セット して おく 必要が ある。 
再配置が 発生す る。 

C の 関数 ►  int  T SBeginDrag ( LP 〇 int  pt) ; 

返り 値は リ ザル トコ ー ド。 


$A%C  TSEndDrag 


引 数 ►  word  皿 ode  =0 

丰。 

返り 値 ►  D0.L  リザルト コード 

機 能 ドラッグを 終了す る。 ビット イメージの データは 開放され る。 
再配置が 発生す る。 

C の 関数 ►  int  TSEndDragdut  mode) ; 

返り 値は リ ザル トコ ー ド。 


$A38D  TSHideDrag 


引数*^ なし 

返り 値 ►  D0.L  リ ザル トコード 
機 能 >  一時的に ラバー バンドを 消す。 すでに 消えて いる 場合は 何もし ない。 
再 配 霞が 発生す る。 

C の 関数 ►  int  TSHideDrag  (void) ; 

返り 値は リザルト コード。 


普通に 終了す る 

ラバー バン ドを 元の 位置まで アニ 
メー シヨ ン させて 終了す る 
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$A%E  TSShowDrag 


引 数 ►  なし 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 >  ラバー バンドを 描画す る。 すでに 描画され ている 場合は 何もし ない。 
再配置が 発生す る。 

C  の 関数 ►  int  TSShowDrag  (void) ; 

返り 値は り ザル トコ ー ド。 


$A38F  TSZeroScrap 


引 数- なし 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  デスクトップ スクラップ バッファの 内容を クリアす る。 

正常に 終了した 場合、 タスク マン イベント 50(T0SCRAP、 "スクラップ ノくッ ファ 
への データ 転送"） が 発生す る。 

再配置が 発生す る。 

C  の 関数 ►  int  TSZeroScrap  (void) ; 

返り 値は リ ザル トコ ー ド。 


$A390  TSPutScrap 


引 数 ►  1〇 丘 良  celLength  ; セル リス トの サイズ 

long  celHdl  ; セ ノレ リス ト への ノ 、ン ドノ レ 

返り 値*^  D0.L  リザ ル トコー ド 

機 能 ►  デスクトップ ス クラ ッ プバ ッ ファに celHdl で 指定した celLength の サイ 
ズの セル リストを セットす る （追加では なく 置換）。 正常に 終了した 場合、 タス 
ク マン イベント 50(T0SCRAP、 "スクラップ バッファへの デー タ転 送"） が 発生 
する。 

疑似 ハン ドル も 可。 

巧 配置が 発生す る。 

C  の 関数 ►  int  TSP  U  t  Scrap  (long  celLength,  Handle  celHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A391  TSGetScrap 


引 数*-  なし 

返り 値 ►  DO.L  デスクトップ ス クラ ッ プバ ッ ファの サイズ 
/ リ ザル トコ ー ド 
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AO.L  デスク ト ップ スクラップ バッファへの ポインタ 
機 能 ►  システム 内の デスクトップ スクラップ バッファへの ポインタを 返す。 

C の 関数 ► long  TSGetScrap (Scrap  **scrap) ; 

返り 値は、 デス ク トップ ス クラ ッ プノ、 •ッ ファの サイズ または リ ザル ト コード。 
Scrap 型の ポインタ scrap には、 デスクトップ スクラップ バッファへの ポ 
イ ンタが 格納され る。 


$A397  TSSearchTrashpath 


引 数 ► long  nameHdl  ; ファイル 名への ハンドル （ASCIIZ 型） 

返り 値 ►  D0.L  =0  発見で きた 

丰り  発見で きなかった 

機 能 ►  nameHdl で 指定した ファイルが ク リーナ のなかに あるか どうかを 調べる。 ファ 
イル 名は フ ル パス で 指定す る 必要が ある。 

C  の 関数 ►  int  TSSearch  Trash  path  (  char  **nameHdl) ; 

返り 値は 結果を 意睐 する 数値。 


$A398  TSSearchTrashf ile 


引 

数- 

Ion 良 

nameHdl 

; ファイル 名への ハン ドル （ASCIIZ 型） 

返り 値 

D0.L 

=  0 

発見で きた 

丰り 

発見で きなかった 

機 

能 ■- 

nameHdl 

で 指定 した フ ァイ ルが ク リーナの なかに あるか どうかを 調べる。 ファ 

イ ルが 含まれる ディ レクト リがク リーナの なかに あった 場合 も、 ク リーナに 含 
まれる ことになる。 ファイル 名は フルパスで 指を する 必要が ある。 

C の 関数 ►  int  TSSearch TrashBle ( chax  **nameHdl) ; 

返り 値は 結果を 慈 味す る 数値。 


$A399  TSEmptvTrash 


引数 なし 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  ク リーナに 含まれる すべての ファイルを 削除し、 ク リーナ ハ* ッ ファを フラッシュ 
する。 正常に 終了した 場合、 タスク マン イベント 目 UEMPTYTRASH、 "ク リー 
ナの フラッシュ’’）  が 発生す る。 

巧 肖 己 置が 発生す る。 

C の 関数 ►  int  TSEmp か Trash  (void) ; 

返り 値は リザ ル トコ ー ド。 
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$A39B 


TSSearchdpb 


引 数 


返り 値 I 


word 

word 

DO.L 

AO.L 


mediabyte  ;  メディア ノ 、•イト 

unitNo  ; ユニッ ト 番号 

ドライ ブ 番号/ リ ザル トコ ー ド 
該当する ドライブの DPB の アドレス 
機 能 ►  mediabyte で 指を した メディア バイトと unitNo で 指を した ユニットを 号 
を 持つ ドライブを 探し、 発見で きた 場合は その ドライブを 号と DPB の アド レ 
ス を 返す。 

C の 関数 ►  int  TSSearchdpb ( int  mediabyte,  int  unitNo) ; 

返り 値は、 ドライブ 番号 または リザルト コード。 

DPB への ポインタを 得る ことは できない。 


$A39D 


TSDrvctrl 


弓 I 数 ►  word 


返り 値*^ 
機能- 


C の 関数 • 


mode 


word  drvNo 


動作 モード 


0 

状態を 返す だけ 

1 

イ ジュク ト する 

2 

イジ X ク トを 禁止す る 

3 

イ ジュク トを 許可す る 

4 

LED 点滅 モー ドに 設定 

5 

LED 点滅 モー ドを 解除 

ドライブ 番号 


0 

ク リーナ 

1 

ドライブ A 

D0.L  ドライ ブの 状態/ リ ザル トコ ー ド 

drvNo で 指定した ドライブに 対して、 皿 ode で 指定した コントロールを 斤 
う。 皿 ode  =  0 の 場合、 ドライブの 状態が 返される。 DOS コー ルの $FF0F 
DRVCTRL と 同様の 動作 を 行う。 

実際に ドライ ブ へのア ク セスは 巧わず、 システム 内部 に 記憶 されて いる 状態を 
返す。 内部に 記惊 されて いるが 態の 更新は、 ドライブの 挿入/イジ ュクト 時に 斤 
われる。 

int  TSDrvctrKlnt  mode,  int  drvNo) ; 

返り 値は、 ドライ ブの 状態 またはり ザル トコー ド。 


$A39E 


TSDrvctrl2 


弓 I  数 ►  word  田 ode 


; 動作 モード 


タスク マン 
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返り 値*^ 
機 能 ► 


0 

状態を 返す だけ 

1 

イ ジ卫ク ト する 

2 

イジ： 11 ク トを 禁止す る 

3 

イジ ュクト を 許可す る 

4 

LED 点滅 モー ドに 設定 

5 

LED 点滅 モー ドを 解除 

word  drvNo  ; ドライブ 番号 


0 

ク リーナ 

1 

ドライブ A 

D0.L  ドライ ブの 状態/ リ ザル トコ ー ド 

drvNo で 指定した ドライブに 対して、 皿 ode で 指を した コントロールを 斤 
う。 ドライブ のが 態は 虹 ode  =  0 の 場合に 返される。 DOS コー ルの $FF0F 


DRVCTRL と 同様の 動作 を 斤う。 


実際に ドライブへの アクセスを 行-い、 さらに フォー マッ トの チェック も 巧う。 
フォー マットが Human68k の フォーマットと 異なる 場合、 ノット レディの ビッ 
卜 を 立てる。 


C の 関数 ►  int  TSDrvctrl2 ( int  mode,  int  drvNo) ; 

返り 値は、 ドライ ブの 状態 または リ ザル トコ ー ド。 


$A3A2  SXCallWindM 


引 数 ►  long  winPtr  ; ウインドウ レコー ドへの ポインタ 

long  tsEventRecPtr  ; タスク マン イベント レコー ドへの ポインタ 

返り 値 ►  D0.L  ウイン ドウの パー ト コー ド/リザ ル ト コード 

機 能 ►  tsEventRecPtr で 指定 した イベント に 対応した 嫂理を winPtr で 指定 した 
ウィン ドウに ず ホして 斤う。 

再配置が 発生す る。 

サポート される 処理は じ [下のと おり。 

•ウィン ドウの 移動 
■ウィン ドウ サイ ズの 変更 
•ウイン ドウの ズーム 

• ク リッフ V)  ON/OFF 

• ウィンドウ のが •厲品 （クロー ズ ボックス、 矢 巧） などの コントロール 
C の 関数 ►  int  SXCaiiWindMCWindow  *winPtr ,  Ts 巨 vent  *tsEventRecPtr) ; 
返り 値は、 ウイン ドウの パー トコード または リザ ル トコ ー ド。 


$A3A3  SXCallCtrlM 


引 数 ► long 


WinPtr 


; ウインド ウレ コー ドへの ポイ ンタ 
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long 

tsEventRecPtr  ; 

: タスク マン イベント レコードへの ホ インタ 

Ion 呂 

ctrlHdlV  ; 

; 垂直 ス クロー ルバ ーへの ハン ドル （省略の 

場合 0) 

long 

CtrlHdlH  ; 

； 水平 スクロール バーへの ハン ドル （省略の 

場合 0) 

long 

dRectPtr  ; 

; スクロールを 行う 領域を 示す レク タング ル 
への ポイ ンタ 

DO.L 

パー トコ ー ド/り ィ尸 ノレ ト 

コード 

AO.L 

コント ロ ー ルへの ハン 

ドル 

機 能 ►  tsEventRecPtr で 指定した イベントに 対応した 化理を winPtr で 指定した 
ウィン ドウに 属する コント ロールに 対して 行う。 

ctrlHdlV,  ctrlHdlH には、 ウィンドウの 部を ス クロー ルさせる ためじ 置い 
た垂 盾:、 水平 各ス クロー ルバ ーへの ハンドルを 指定す る。 dRectPtr には、 ス 
クロールを 巧う 領域を 示す レク タング ルへの （疑似） ポインタを 指定す る。 こ 
れ によって、 指定した 範囲を 超える ような スクロールは 斤わない ようじなる。 
ctrlHdlV,  CtrlHdlH,  dRectPtr は、 ス クロー  ノ レノ、* 一の 化理 か* 不要なら 
ば墙 '略 可。 

再配置が 発生す る。 

サポート される 化理 はな 下のと おり。 

• セレクト ボタン/オルタ ネート ボタンの ON/OFF 
• スクロール バーに よる スクロール 

C の 関数 ►  int  SXCallCtrlM (Window  *winPtr ,  TsEvent  *tsEveiitRecPtr , 
Control  **ctrlHdlV,  Control  **ctrlHdlH,  Rect  *dRectPtr , 
Control 幸 本 幸 Ctrl) ; 

返り 値は、 コント ロ ー ルの ハ ト コード または リ ザル トコー ド。 

Control 型の ハンドル Ctrl には、 操作され た コントロールの ハンドルが 格 
納 される。 


$A3AA 


SXInva 丄 ScBar 


弓 I 数 ►  long  winPtr  ; ウインドウ レコードへの ポインタ 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  WinPtr で 指定した ウィンドウ レコードの 垂盧 •水平 ス クロー ルバー の 描画 さ 
れる 部分を アップ デー トリー ジョ ン に加える。 

再配置が 発生す る。 

C の 関数 ►  int  SXJuvaiScBarCWindow  *wiiiPtr) ; 

返り 値は リ ザル トコ ー ド。 
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$A3AB 


SXValidScBar 


引 数 ►  Ion 良  winPtr  ; ウインドウ レコードへの ポインタ 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  WinPtr で 指を した ウインドウ レコードの 垂直 •水平 スクロール バーの 描画 さ 
れる 部々 を アップデート リー ジョンから 除く。 

再配置が 発生す る。 

C の 関数 ►  int  SXVaiidScBar (Window  *winPtr) ; 

返り 値は リ ザル トコー ド。 


$A3BB 

TSISRecToStr 

引 数- 

long 

ISRecPtr 

； アイコ ン 管理 レコー ドへの ポインタ 

long 

dstr 

； フルパス 名が 返る バッファ （90 バイト） の 

ア ドレス 

返り 値 ► 

DO.L 

パス 名の 長さ/リザ ル トコー ド 

AO.L 

パス 名の 終端 + 1 

機 能- 

ISRecPtr で 指定した アイコ ン 管理 レコー ドから フルパス 名を 作成し、 dstr 

じ 返す。 

C の 関数 ►  int  TSISRecToStr (IcState 

本 ISRecPtr,  char  本 dstr) ; 

返り 値は、 

パス 名の 長さ または リ ザル トコー ド。 

$A3BF 

TSCreateISFile 

引 数- 

long 

nameHdl 

; ファイル 名への ハン ドル （ASCIIZ 型） 

long 

ISRecPtr 

; アイコ ン 管理 レコ ー ドへの ポイ ンタ 

返り 値 ■- 

DO.L 

フ アイ ルの 種類 

ファイル または サブ ディ レクト リ 
クリ ーナの ルー ト ディレクトリ 
ク リーナの ファイル または デイ レクト 
ルー ト ディレクトリ 


A0.L  アイコ ン 管理 レコ ー ドへの ポイ ンタ 

機能 ►  nameHdl で 指定した ファイル 名を もとに ISRecPtr で 指定した アドレスから 
アイコン 管理 レコ ー ドを 作成す る。 ファイル 名は フルパスで 指定す る 必要が あ 
る。 

再配置が 発生す る。 

C の 関数 ►  int  TSCreateISFile ( char  **nameHdl , IcState  *ISRecPtr) ; 

返り 値は 結果を 意味す る 数値。 
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$A3CC  SXFileConnPath 


引 数 ► long  namePtr  ; ファイル 名への ポインタ （ASCIIZ 型） 

long  pathPtr  ; パス 名への ポインタ （ASCIIZ 型） 

返り 値 ►  D0.L  =0  ファイルの パスは pathPtr と 等しくない 

丰。  ファイルの パスは pathPtr と 等しい 

機 能 ►  namePtr で 指を した ファイルの パス カ、*、 path? れで 指定した パスと 等しい か 
どうかを 調べる。 ファイル 名、 パス 名は フルパスで 指定す る 必要が ある。 

C の 関数 ►  BOOLEAN  SXFileConnPath  (const  char  *namePtr ,  const  char 
幸 pathPtr) ; 

返り 値は 結果を 意味す る 数値。 


$A3CD  SXFileInPath 


引 数 


返り 値 ► 


機 能 > 


long  namePtr  ; ファイル 名への ポインタ （ASCIIZ 型） 

long  pathPtr  ; パス 名への ポイ ンタ （ASCIIZ 型） 


D0.L 

0 

フ ァイ ルの パスと pathPtr は 等 しい 

1 

ファイルは pathPtr 上に ある 

-1 

ファイルは pathPtr 上 じない 

namePtr で 指定 した ファ イ ルが pathPtr で 指を した パス に 含 まれる かどう 
かを 調べる。 ファイル 名、 パス 名は フルパスで 指定す る 必要が ある。 


C の 関数 ►  int  SXFileInPath ( c ons t  char  *nainePtr,  const  char  *pathPtr) ; 


返り 値は 結果を 意味す る 数値。 


$A3D0 

SXFnamecmp 

引 数 

long 

namePtr 

; ファイル 名への ポインタ （ASCIIZ 型） 

word 

name し e 打 gth 

; 名前 部分の 長さ （通常は 0 を 指定） 

long 

maskPtr 

; マスク 义字 列への ポイ ンタ （ASCIIZ 型） 

word 

皿 ask し ength 

; マスク 文字列の 名前 部 かの 長さ （通常は 0 
をキ 旨定） 

返り 値 •- 

DO.L 

0  完全に マッ 

チした 

名前と お 張子の どちら かで を 使用して マッチ 

名前と お 張子の どちら か 一方が"*’’ のみで マッチ、 または、 名 

前 お 張子 両方で を 使用して マッチ 

名前と お 張子の 両方で‘'*’’ を 使用し、 かつ、 どちら か 一方が 
のみで マッチ 
"幸.*" で マ ツチ 
マッチし ない 


機 能- 


namePtr で 指定 した ファ イ ル 名と 虹 askPtr で 指定 した マスク 文字列が マツ 
チす るか どうかを 調べる。 大文字と 小文字は 区別され る。 
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C の 関数 ►  int  SXFnamecmp (const  char  *nainePtr ,  int  nameLength, 
const  char  幸 maskPtr,  int  虹 askLength) ; 

返り 値は 結果を 意味す る 数値。 


$A3D4 

SXSearchFname 

引 数- 

long 

namePtr 

; ファイル 名への ポインタ （ASCIIZ 型） 

返り 値 ► 

DO.L 

が: 張子 

AO.L 

ファイル 名の 先頭 

機能- 

namePtr で 指定した フルパスの ファイル 名のな かの、 ファイル 名が 始まる 位 

置を 返す。 

C の 関数 ► 

long  SXSearchFname const 
返り 値は 拡張 子。 

char  *nainePtr ,  char  * 本 top) ; 

char 

型の ポイ ンタ top 【こは、 

ファイル 名の 先頭 位置が 格納 される。 

$A3D8 

SXStoLower 

引 数 > 

long 

StrPtr 

; 文字列への ポインタ 

word 

length 

； 変換す る バイト 数 

返り 値 ► 

なし 

機能- 

strPtr で 指定した 文字列を length バイ ト だけ 小文字に 変換す る。 

$A3D9 

SXStoUpper 

引 数 

long 

StrPtr 

; 文字列への ポインタ 

word 

length 

； 変換す る バイト 数 

返り 値*^ 

なし 

機能 

StrPtr で 指定した 文字列を length バイ ト だけ 大文字に 変換す る。 

$A3DA 

SXStoUpper2 

引 

数 ■- 

long 

buf Ptr 

; 結果が 返る バッファの ア ドレス 

long 

StrPtr 

; 文字列への ポインタ 

word 

length 

； 変換す る バイト 数 

返り 値 ► 

なし 

機 

能- 

StrPtr 

で 指定した 文字列を length バイ ト だけ 大文字に 変換し、 bufPtr 

で 指定 さ れたバ ッ ファ に 返す。 
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$A3E9 


SXVer 


引 数  >  なし 

返り 値 ►  DO.L  SX システムの バージョン 番号 

機 能 ►  SX-WINDOW のバー ジョン 番号を 返す。 ver.3.10 ならば、 返り 値は 0x0310 と 
なる。 

C の 関数 ►  int  SXVer(void) ; 

返リ 値は バージョン 番号。 


$A3EA 


TSTakeParam 


引数 ► 1011 良 
long 


commandPtr 

wRectPtr 


long  namePtr 


word  mode 


; コマンド ライ ン 文字列 （LASCII 型） への 
ポインタ 

; レク タング ルレ コード カぶ 返る バッファの ア 
ドレス 

; 文字列が 返る バッファ （90 バイト） の アド 

レス 

; argc,  argv 保存 モード 


0 


2 


argc,  argv を 保存し ない 

argc,  argv の ブロックを 作成して 保な 

argc,  argv •を  destBuff  に 保存 


返り 値 


機能 I 


long 

DO.L 


AO.L 


destBuff  ; axgc ,  argv を 保存す る バッファ 

bitO  ウィン ドウ 位置 指定が あった 
bitl  文字列が あった 

/ リザ ル トコード 

argc ,  argv を 保存し たバ ッ ファ への ポイ ンタ 
commandPtr で 指定 された コマン ドライ ン 文字列を 解析す る。 

ウィン ドウ 位置の 指定 オプション ("-Wx0,y0,xl,yl") が あった 場合は、 wRect 
Ptr で 指定 された バッファに レク タング ルレ コードを 返す。 

ウィン ドウ 位置の 指定 オプション U 外の 文字列は 要素に 分けられ、 argc (要素 
数）、 argv (要素の 文字列） の テーブルが 作成され る。 

再配置が 発生す る。 

•  mode  =  0 の 場合 ： 保存し ない 

作成した テー ブル は 化理の 終了 時に 廃棄 され、 アプリ ケーシ ョンに は 返さ 
れ ない。 

destBuff は 意味を 待たない。 

• 皿 ode  = 1 の 場合 ： ブロック を 作成 して 保存 

再配置 不能 ブロックが 作成され、 そのな かに テー ブルが 作成され る。 アプ 
リ ケー ショ ン には、 その ブロ ッ ク への ポイ ンタが 返される。 
destBuff は 意味を 持たない。 
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柿 入され ていない ドライ ブ だけ 調べる 
すべての ドライブを 調べる 


引 数 ►  word  皿 ode  ; ドライブを チェック する モード 


返り 値- D0.L  リザルト コード 

機 能 ►  ドライブを 調べ、 それまで じ 挿入/イジ ェクト が 発生して いたら、 イベントを 発 
生させる。 

再配置が 発生す る。 

C の 関数 ►  int  TSDriveCheckAU ( int  mode) ; 


• 皿 ode  =  2 の 場合 ： destBuff に 保存 

destBuff で 指を した バッファ じ テー ブルが 作成 される。 

いずれの 場合 も、 最後の 要素の 文字列が namePtr で 指を された バッファに 返 
る。 

テーブルの 内容は 次のと おり。 

+$00  .L  要素 数 （argc) 

+ $04.L  最初の 要素への ポインタ （argv[l]) 

+$08  .L  2 番目の 要素への ポインタ （argv に]) 

C の 関数 ►  int  T S TakeParam  (const  _LASCII  commandPtr ,  Rect  *wRectPtr , 
char  本 namePtr,  int  田 ode,  char  幸 幸 destBuf ± ,  char  * 幸 argvc) ; 
返り 値は、 結果を 意味す る フラグ または リザ ル ト コード。 
char 型の ポインタ argvc には argv,  argc を 格納す るた めに 礎 保した 
ブロ ッ ク への ポイ ンタが 格納され る。 


$A3F4  TSFindTskn 


引 

数- 

long 

namePtr 

； タスク 名を 示す 文字列 (ASCIIZ 
ポインタ 

型） への 

word 

taskID 

; タスク ID 

返り 値 

DO.L 

タスク ID (下位 ワー 

ド）/ リザ ル トコー ド 

機 

能- 

現在 登録され ている タスクの うち、 taskID より 大きな ID を 持ち、 

namePtr 

で 指定 した タスク 名と 一致す る も のを 検索し、 最初に みつか っ たもの の タスク 
ID を 返す。 

タスク 名には ワイル ド カー ドを 使用す る ことが 可能。 

taskID として- 1 を 指定した 場合、 タスクのに 無関係に 検索す る。 

C の 関数 ► long  TSFindTskn ( const  char  *nainePtr ,  int  taskID) ; 

返り 値は、 タスク ID または リザルト コード。 


$A3F7  TSDriveCheckAU 


〇  〇 
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返り 値は リザルト コード。 


$A3F8  TSDriveCheck 


引 数 ►  word  drvNo  ; ドライ ブ 番号 

返り 値 D0.L  ドライブ のが 態/リザルト コード 

機 能 ►  drvNo で 指定した ドライブを 調べ、 それまでに 挿入/イジ ェクト が 発生して い 
たら、 イベントを 発 先させる。 返り 値の ドライブの 状態は、 $A39D  TSDrvctrl 
などと 同様、 DOS コールの $FF0F  DRVCTRL の 返り 値と 同様の 意味を 持つ。 
再配置が 発生す る。 

C の 関数 ►  int  TSDriveCheck ( int  drvNo) ; 

ドライ ブの 状態を 意味す る 数値、 または リ ザル トコ ー ド。 


$A3F9 

TSISRecToExec 

引 数 

long 

ISRecPtr 

; アイコ ン 管理 レコ ー ドへの ポインタ 

long 

namePtr 

; 実行 ファイル 名が 返る バッファ （90 バイト） 
のア ドレス 

long 

commandPtr 

; コマンド ライ ン 文字列 （LASCII 型） が 返 
る バッファ （256 バイト） のア ドレス 

返り 値 ► 

DO.L 

リ ザル ト コード 

機 能 ►  ISRecPtr で 指定した アイコ ン 管理 レコー ドから 起動す る ファイルの 名前と コ 
マンドラ イン 文字列を 作成し、 それぞれ namePtr ,  commandPtr で 指定され 
た バッファに 返す。 

再配置が 発生す る。 

C の 関数 ►  int  TSISRecToExec ( I cS t at e  *ISRecPtr ,  char  *namePtr , 
_LASCII  commandPtr) ; 

返り 値は リザルト コード。 


$A3FA  TSGetDtopMode 


引 数  >  なし 

返り 値 ►  DO.L  =0  デスクトップを 保存し ない 

丰り  デスク ト ップ をつ わに 保存す る 

機能  >  画面 状態 保存 モード を 返す。 

C の 関数 ►  BOOLEAN  TSGetDtopModeCvold) ; 

返り 値は 結果を 意味す る 数値。 


タスク マン 


454 


タスク マン 


$A3FB 


TSSetDtopMode 


引数 ►  word 


虹 ode 


画面が 態 保存 モード 


デスク ト ップを 保存し ない 
デスク ト ップ をつ わに 保存す る 


返り 値 ►  なし 

機 能 ► 画面 状態 保存 モードを mode じ 設定す る。 
C の 関数 ►  void  TSSetDtopMode ( int  mode) ; 
返り 値は ない。 


$A3FC 


TSSearchOpen 


引 数 


返り 値 


機 能- 


C の 関数 I 


long 

word 

word 

DO.L 


nameHdl 

mode 

filelD 


ファイル 名への ハ: 
アクセス モード 

フ アイ ルハン ドル 


ドル （ASCIIZ 型） 


0 

発見で きた 

-1 

発見で きなかった 

A0.L  該当する 才 ープン ファイル 名 管理 レコ ー ドへの ポインタ 

nameHdl の 名前で、 mode の アクセス モードで 才 ープン されて いて filelD 
の ファイル ハン ドルを 持つ ファイルが 存在す るか どう かを 調べる。 発見で きた 
場合は、 該当する オープン ファイル 名管埋 レコードの ポインタが 返る。 この ポ 
インタ は 再配置 可能 ブロ ック 内を 指して いるので、 再配置が 発生し た 場合は 無 
効になる ことにを 意。 

int  TSSearchOpen ( char  幸* nameHdl, int  皿 ode, int  fiieiD, 
OpenFile  幸 幸 open) ; 

返り 値は、 結果を 意味す る 数値。 

OpenFile 型の ポインタ open じは、 才 ープン ファイル 名 管理 レコードへの 
ポイ ンタが 返る。 


$A3 咒 


TSFindOwn 


引 数 なし 

返り 値*^  DO.L  タスクの （下位 ワー ド）/ リザ ル トコード 

機 能 ►  現在 登録され ている タスクの うち、 この コールを 呼んだ タスクと 同じ 名前の 夕 
スクを 検索し、 最初に みつかった ものの タスク ID を 返す。 

C の 関数 ► long  TSFindOwn  (void) ; 

返り 値は、 タスク ID または リザルト コード。 
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$A3FF 

TSCommunicateS 

引 数 

word 

listener 

; 宛先と なる タスクの ID 

long 

tsEventRecPtr 

; タスク マン イベント レコ 

word 

mode 

； 返答 モード 

返事を 受けが けない 
返事を 受け かける 


返り 値 ►  DO.L 


0 

正常終了 

1 

返事が 届いた 

-1 

宛先の タスクが 存在し ない 

-2 

宛先の タスクの 準備が 整って いない 

<0 

リザルト コ ー ド 

機 能 ►  listener で 指定した タスク じ tsEventRecPtr で 指定した タスク マン イべ 
ント レコー ドの 内容の イベントを 発生させる。 すなわち、 タスク マン イベント 
レコ ー ドの 内容に よって タスク 閒 通信を 斤う。 宛先の タスク に 発生させる イべ 
ント は、 イベント レコード 中に 自 あに 設定で きる。 

スーパ ユーザ 専用で あり、 タスク ID が 0  (つまり、 シ卫 ル） の タスク 外は 使 
用して はならない。 

再配置が 発生す る。 

C の 関数 ►  int  TSCommunicateS ( int  listener,  TsEvent  *tsEventRecPtr , 
int  mode) ; 

返り 値は、 結果を 意味す る 数値 または リザ ル トコ ー ド。 


$A402 

TSSearchFile2 

引 数 

byte 

model  ; 

検索 モ 

ー ド 1 

0 

0 

ダイアログを 表示し ない 

皿〇过 el 回の 探したら、 ダイアログ 

を 表示す る 

byte 

mode2  ; '‘ 

検索 モード 2 

long 

long 

long 


SFRecPtr 

sNamePtr 

dNamePtr 


0 

1 個 ファイルを みつけて 終了 

1 

複数 検索 : 

: 嚴 初の 検索 

2 

お数 検索 : 

:  2 回目 U 降の 検索 

3 

複数 検索 : 

: 終了 処理 

4 

複数 検索 : 

: ダイアログの アップデート 

long  parnPtr 


ファイル 検索 レコード （268 バイト） への ポ 
インタ 

ファイル 名 （ASCIIZ 型） への ポイ ンタ 
該当 ファイル 名が 返る バッファ （90 バイト） 
のア ドレス 

カレント パス 名 (ASCIIZ 型） への ポインタ 
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返り 値 ►  DO.L  ファイル サイズ/リザルト コード 

機 能 ►  sNamePtr で 指定した ファイルを 検索し、 発見で きた ファイルの 名前を dName 
Ptr に 返す。 檢 索は、 sNamePtr のなかに パスが 含まれる 場合は その パス か 
ら、 そうでない場合は pathPtr で 指定した パスから 開始す る。 そこで 見つか 
ら なかった 場合は、 ドライブ A の ルート ディ レクト リ から 順に 検索して いく。 
田 odel が 0  la 外の 場合、 model で 示される 回数 だけ 探した ところで ダイア 
ログを 表示す る。 

sNamePtr は dNamePtr と 同じ ものを 指定しても よい。 

複数個の ファ イ ルを 検索す る 機能が 用意 されて いる。 

再配置が 発生す る。 

• 皿 ode2  =  0 の 場合： 1 個 ファイルを みつけて 終了 

sNamePtr での 指定に マッチす るよう な ファイルの 最初の 1 つを 発見し 
たら 終了す る。 つまり、 $A403  TSSearchFile と 同様。 SFRecPtr は 意 
味を 持たない。 

•  mode2  = 1 の 場合： 複数 検索： 最初の 檢索 

複数個の ファ イ ルを 検索す るた めの 準備 （ファ イ ル 検索 レコ ー ドの 初期化） 
を 斤い、 sNamePtr での 指定に マッチす るよう な ファイル のうち 最初 じ 見 
つかった ものを 返す。 1 つ ファイルを 発見す るか、 1 ドライブ 探した ところ 
で 帰 って くる。 

• 皿 ode2  =  2 の 場合： 複数 検索：  2 回目り、 降の 検索 
皿 ode2  = 1 で 行った 化理の 続きを 斤う。 

• 皿 ode2  =  3 の 場合： 複数 検索： 終了 化理 
複数個の ファ イ ルの 檢 索の 終了 処理を 斤う。 

• 皿 ode2  =  4 の 場合： 複数 検索： ダイアログの アップデート 

ダイアログを 巧 描画す る。 複数 検索を 巧って いる 途中で アップ デ ー トイべ 
ン トが 発生した 場合の ため。 

C の 関数 ►  int  TSSearciiFiie2(B00LEAN  model, int  mode2 , void  *SFRecPtr, 
const  char  本 sNamePtr ， char  幸 dNamePtr , const  char  本 pathPtr) ; 
返り 値は、 ファイル サイ ズ または リザ ル トコー ド。 


$A403 

TSSearchFile 

引 数 

long 

sNamePtr 

; ファイル 名 （ASCIIZ 型） への ポインタ 

long 

dNamePtr 

; 発見した ファイルの 名前 力 {返る バッファ （90 
バイト） のア ドレス 

long 

pathPtr 

; パス 名への ポイ ンタ （ASCIIZ 型） 

返り 値 

DO.L 

ファ イ ル サイズ/ リ ザル トコ ー ド 

機 能 ►  sNamePtr で 指定した ファイルを 検索し、 発見で きた ファイルの 名前を dNamePtr 
に 返す。 検索は、 sNamePtr のなかに パスが 含まれる 場合は その パスから、 そ 
うでない 場合は pathPtr で 指定した パスから 開始す る。 そこで 見つからな 
かった 場合は、 ドライブ A の ルー ト ディ レクト リ から 顺じ 検索して いく。 
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ある 程度 検索した ところで ダイアログを 表示す る。 
dNamePtr は sNamePtr と 同じ ものを 指定しても よい。 

再配置が 発生す る。 

C の 関数 ►  int  TSSearchFile ( c ons t  char  *sNamePtr ,  char  SNamePtr, 
const  char  本 path) ; 

返り 値は、 ファイル サイズ または リザルト コード。 


$A406 

SXStrCmp 

引 数 

long 

sStrPtr 

文字列 1 への ポインタ 

long 

dStrPtr 

文字列 2 への ポインタ 

word 

length 

比較す る バイト 数 

返り 値 ► 

DO.L 

=  0 

一致 

丰り 

一致し ない 

機 能 ►  sStrP む： で 指を された 文字列と dStrPtr で 指定され た 文字列を、 length 
バイ ト だけ 大文字- 小文字を 無視して 上ヒ較 する。 

C の 関数 ►  int  SXStrCmp iconst  char  *sStrPtr ,  const  char  *dStrPtr , 
int  length) ; 

返り 値は 結果を 意味す る 数値。 


$A408 

TSCre at  e I SBadge 

引 数 

long 

ISRecPtr 

; アイコ ン 管理 レコー ドへの ポイ ンタ 

word 

mediabyte 

； メディ アバ イト 

word 

unitno 

； ユニット 番号 

返り 値 

DO.L 

リ ザル トコー ド 

機 能 ►  mediabyte,  iinitno で 指定した メディア バイ トと ユニット 番号から アイコ 
ン 管理 レコードを 作成す る。 

再配置が 発生す る。 

C  の 関数 ►  int  TSCreatelSBadge  ( I  c  St  at  e  *ISRecPtr ,  int  mediabyte , 
int  unitno) ; 

返り 値は リ ザル トコ ー ド。 


$A40A  TSGetCMDS 

引 数 ►  word  cmdID  ; ビルトイン コマンドの 番号 

long  buffPtr  ; コマン ド 名 （ASCIIZ 型） 力 《返る バッファ 

のア ドレス 

返り 値 ►  DO.L  リソース で 日 DE’ の ID/ リ ザル トコ ー ド 
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AO.L  コマン ド 名の 終端 + 1 

機能 ►  cmdlD で‘ 指定した ビルトイン コマンドの 名前 （ASCIIZ 型） と、 コマンドの 
コー ドが 収められ ている リ ソース ‘CODE’ の ID を 返す。 

再配置が 発生す る。 

C の 関数 ►  int  TSGetCMDS ( int  cmdID ,  char  *buf  fPtr) ; 

返り 値は、 リ ソース ID または リザ ル トコード。 


$A40B 

TSFockCM 

引 数 

byte 

model 

起動 モード 1 

byte 

皿 ode2 

起動 モード 2 

long 

cmdsID 

リ ソース "CMDS" の の 

long 

commandPtr 

コマンド ライ ン 文字列 （LASCII 型） への 

ポインタ 

long 

environPtr  ; 

: 環境への ポインタ 

long 

dFilename  ; 

: 実際に 起動した ファイル 名が 返る バッファ 
(90 バイト） のア ドレス 

返り 値 ► 

DO.L 

タスク ID/ リ ザル トコ - 

-K 

機 能 ►  cmdsID で 指定した を 号の ビルトイン コマンドを 起動す る。 

タスクには、 commandPtr で 指定 した コマン ドラ イン 文字列と environPtr 
で 指定した 環境が 渡される。 environPtr として 0 を 指定す ると、 タスク マン 
の 環境を 使用す る ことになる。 

皿 ode 1 は $A351  TSFock と 同様の 意味を 持つ。 

mode2 として 0 外を 指定した 場合、 起動した （しようと した） ファイル 名 
を dFilename に 返す。 

再配置が 発生す る。 

C  の 関数 ►  int  TSFockCM  (int  model , BO  GLEAN  mode2,int  cmdsID,  const 

char  * commandPtr , const  char  *enviro 打 Ptr , char  本 dFile 打 ame) ; 
返り 値は、 タスク ID または リザ ル トコー ド。 


$A40D  TSTiniTsk 


引数 なし 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  タスク マンの 終了 処理 （システム リソ ースの クロー ズ 、すべての マネージャの 
終了 処理） を 斤う。 

再配置が 発生す る。 

C の 関数 ►  int  TSTiniTs も （void) ; 

返り 値は リ ザル トコー ド。 
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$A415 

TSPostEventTsk2 

引 数- 

long 

皿 esl 

メ ッセ ー ジ 1 

long 

mes2 

メ ッセ ー ジ 2 

word 

what  2 

タスク マン イベント コード 

byte 

Hmodel 

ハン ドル モード 1 

byte 

Hmode2 

ハン ドル モード 2 

word 

taskID 

イベント を 発生させる タスクの ID 

返り 値 

DO.L 

リ ザル トコ ー ド 

機 能 ►  mesl, 皿 es2,  what 2 で’ 指を した データを、 それぞれ whom,  whom2 ,  what 2 
じ 持つ よう な タスク マン イ ベン トレ コー ドを 作成し、 taskID で 指定した タス 
クに イベントと して 発生させる。 この イ ベン トの 種類は 12(E_SYSTEM1) に 固 
定。 

who 皿 あるいは whom2 に 格納され ている 引数が ハン ドルで ある 場合、 Hmodel 
あるいは Hmode2 に 0 じ I 外を 指定す ると、 別の ブロックを 作成して who 皿， 
who 虹 2 が 指す ブロ ックの 内容を コ ピーす る。 タスク マンの イ ベン トキ ューに 登 
録 される タスク マン イベント レコードの whom,  whom2 に は 新しく 作成し たブ 
ロックへの ハンドルが 格納され る。 この場合、 タスク マン イベント レコードを 
廃棄す る 際、 これらの ブロックは 同時に 廃 薬され る。 

再配置が 発生す る。 

C の 関数 ►  int  TSPostEventTsk2 (long  皿 esl,  long  皿 es2,  int  what 2, 
BOOLEAN  Hmodel , BOOLEAN  Hmode2 ,  int  taskID) ; 

返り 値は リ ザル トコ ー ド。 


$A417  TSAnswer 


引 数 ► long  tsEventRecPtr  ; タスク マン イベント レコー ドへの ポインタ 


0 

正常終了 

-1 

通信 中では ない 

-2 

宛先の タスクの 準備が 整って いない 

機 能 ►  tsEventRecPtr で 指定した イベント レコードの [巧容 を、 タスク 間 通信に がす 
る 返事と して 通信 ネ目 手の タスクに 返す。 

再配置が 発生す る。 

C の 関数 ►  int  TSAnswer (TsEvent  *tsEventRecPtr) ; 

返り 値は 結果を 意味す る 数値。 


$A418  TSSendMes 


引 数 ►  word  listener  ; 岁臣 先と なる タスクの ID 

long  tsEventRecPtr  ; タスク マン イベント レコードへの ポインタ 
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返り 値 ►  DO.L  0 正常終了 

2  返事が 届いた 

-1 宛; 化の タスク がな かしな い/通信 中 
-2  I 宛先の タスクの 準備が 整って いない 

機 甚長 ►  listener で 指定した タスクに tsEventRecPtr で 指を した タスク マン イ ベン 
トレ コードの 内容を メッセージ としてを 信す る。 返事が あった 場合は、 tsEvent 
RecPtr のなかに 返事が 返る。 

再配置が 発生す る。 

C の 関数 ►  int  TSSendMes ( int  listener,  TsEvent  *tsEventRecPtr) ; 

返り 値は 結果を 恵 味す る 数値。 


$A419  TSGetMes 


引 数 


返り 値 > 


機 能 


long  tsEventRecPtr  ; タスク マン イベント レコー ドへの ポインタ 

woru  皿 ode  |  0 1 受け付けなかった ことじす 言~ 

受け付けた ことを 通知す る 


DO.L 

0 

メ ッ セージは 届いて いない 

1 

メ ッ セー ジを 受け取った 

tsEventRecPtr で 指定 した タスク マン イ ベント レコ ー ドに メ ッ セー ジを 読み 
込む。 皿 ode で 0 を 指定した 場合は、 相手には -2  (「宛先の タスクの 準備が 
整って いない」） が、 oia 外を 指定した 場合は 0  (「正常終了」） が 返る。 

起動 直後に メ ッ セージを 受け付ける 場合に 使用す る。 


C  の 関数 ►  int  TSGetMes  (TsEvent  *tsEventRecPtr ,  BOOLEAN  mode) ; 


返り 値は、 結果を 意味す る 数値。 


$A41A  TSInitTsk2 


引数 ► long 
long 
long 

byte 

byte 

word 
Ion 良 

返り 値 ►  DO.L 
AO.L 


皿  emStart 

memEnd 

pathPtr 


ヒープ ゾーン 先頭 ア ドレス 

ヒープ ゾーン 終了 ア ドレス 

々レン ト パスを 示す 文字列 （ASCIIZ 型） へ 

のポイ ンタ 


model 

mode2 


； シュルの リ リース 番号 （1 〜） 

; システムり ソース ヒープ ゾーン 作成 フラグ 


0 

作成し ない 

丰〇 

作成す る 

ver  ; シェルの バー ジョン 

rscfilePtr  ; システム リソース 名 （ASCIIZ 型） への ポ 

インタ （90 バイト） 

ヒープ ゾーンの ア ドレス/ リ ザル ト コード 


システム リ ソースへの ハン ドル 
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機能 ► タスク マ ン U 下の マネ ー ジャを すべて 初期化す る。 

$A34C  TSInitTsk との 違いは、 rscfilePtr じよって システム リソー スフ ア 
イ ルを 指を できる 点。 rscfilePtr が 0、 あるいは 先頭 1 バイ トが〇 の 場合、 
デフォルトの "SYSTEM  .LB" が 使用され る。 また、 実際に 才 ープン した フ アイ 
ル 名が rscfilePtr に 格納され るた め、 文字列を 格納す る 領域は 90 バイト 
必要。 

C の 関数 ►  Heap  *TSnntTsk2 (void  *meinStart,  void  * 皿 emEnd,  const  char 
*pathPtr , int  model , BOOLEAN  mode2 , int  ver , char  *rscf ilePtr , 
Handle  *resHdl) ; 

返り 値は、 ヒープ ゾーンの ア ドレス または リザ ル ト コード。 

void 型の ハン ドル resHdl には システム リ ソースへの ハン ドル カ {格納され る。 


$A41F 

SXCallWindM2 

引 数- 

long 

winPtr 

; ウインド ウレ コー ドへの ポイ ンタ 

long 

tsEventRecPtr 

; タスク マン イベント レコードへの ポインタ 

long 

rectPtr 

; レク タング ルレ コードへの ポインタ 

返り 値 ► 

DO.L 

ウイン ドウの パー トコ 

ー ド/ リ ザル トコード 

機 能 ►  $A3A2  SXCallWindM と 同様の 化理を 斤う。 

rectPtr で 指定す るレク タング ルで ウィン ドウ サイズ 変更 時の 最大 サイズ、 最 
小 サイズを 指定で きる 点が 異なる。 左上の 座標が 最小 サイズ、 右下の 座標が 最 
大 サイ ズを 意味す る。 

再配置が 発生す る。 

C の 関数 ►  int  SXCall WjndM2 (Window  *winPtr ,  TsEvent  *tsEventRecPtr , 
Rect  幸 rectPtr) ; 

返り 値は、 ウイ ン ドウの パー トコー ド または リザルト コード。 


$A420 

TSBeginDrag2 

引 数- 

long 

pt 

； ドラッグ 1 调始 位置 （グローバル 座標） 

long 

procPtr 

； ラバー バンド 表示 ル _ チンの アドレス 

long 

pax  am 

； ラバー バンド 表示 ルーチン じ 渡される パラ 

メータ 

返り 値 ► 

DO.L 

り ザル トコード 

機 能 ►  pt で 指定した ポイントから ドラッグを 開始す る。 $A38A  TSBeginDr% とは、 
ラバ— バンド 表示 ル— チンを 指定で きる 点で 異なる。 procP れで〇 を 指定 
する と 標準の ラバー バン ド 表示 ルーチンが 使用され るが、 この場合は アイコン 
管理 レコー ドの みサ ポート される。 

あらかじめ々 レン ト グラフ レコードを セット して おく 必要が ある。 

ラバ-バン ド 表示 ルー チンへは、 次の よう な パラメータが A0 経由で 渡される。 


タスク マン 


462 


タスク マン 


(aO)  .L ドラッグ レコ ー ドへの ポインタ 
4(a0)  .W  コマンド 

6(a0)  .L  TSBegiiiDrag2 で ホ旨定 した パラメータ 
コマンドには 「初期化」、 「表示」、 「消 ま」、 「終了」 の 4 つが 存在し、 その 仕様 
はの TF のと おり。 

•  command  =  0  : 初期化 

最初に 1 度 だけ 呼ばれる。 標準の ラバー バンド 表示 ルーチンでは ビット イ 
メー  ジの 作成が 行 •われる。 

•  command  = 1 : お 

終了 時に 呼ばれる。 初期化 時に 確保した メモリの 廃棄 等を 行う。 

•  command  =  2  : 表 7K 

ラバ-バンドを 表示す る。 ドラッグ レコードの drOrigin を 引数に して 
$A13B  GMSetHome をコー ルす る ことで 移動した 分の ローカル 座標が セッ 
卜 される。 

•  command  三 3  :  ’消击 

ラバー バンドを 消ます る。 ドラッグ レコードの か Origin を 引数に して 
$A13B  GMSetHome を コールす る ことで 移動した 分の 口一々 ル 座標が セッ 
卜 され^る。 

C の 関数 ►  int  TSBeginDrag2 ( LP oint  pt,  void  幸 procPtr,  long  param) ; 
返り 値は リ ザル トコ ー ド。 


$A422  SXGetVector 


引 数 ►  word  intNo  ;SX コール 番号 

返り 値 >  D0.L  ベクタの 内容/リザルト コード 

A0.L  ベクタの 内容 

機 能 >  intNo で 指定した SX コールの ベクタを 返す。 

C  の 関数 ►  void  *  SXGetVector  (int  intNo) ; 

返り 値は、 ベクタの 内容 または リザ ル トコー ド。 


$A423 

SXSetVector 

引 数- 

word 

intNo 

;SX コール 番号 

long 

vector 

； 登録す るア ドレス 

返り 値 ► 

DO.L 

前の ベクタの 内容/ リ ザル トコ ー ド 

AO.L 

前の ベクタの 内を 

機能 ►  intNo で 指定した SX コー ルの ベクタと して vector を殼定 する。 
C の 関数 ►  void  *SXSetVector( int  intNo,  void  幸 vector) ; 

返り 値は、 前の ベクタの 内容 または リザルト コード。 


タスク 7 ン 
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$A427 


TSCellToStr 


引 

数*^ 

long 

celHdl 

; セル リス ト への ハン ドル 

long 

buf fPtr 

； 結果が 返る バッファの ア ドレス 

long 

田 ax 

; バッファの サイズ 

返り 値 ► 

DO.L 

义字 列の バイト 数/ リ ザル トコ ー ド 

AO.L 

文字列を 収めた バッ 

ファへの ハンドル （確保し なかった 場合は 0) 

機 

能 

celHdl 

で 指定 した セル リスト から 文字列を 抽化 し、 buffPtr で 指定 した バッ 

ファに 返す。 max で 指定した バッファの サイズを 超えた 場合、 エラーと なる。 
buffPtr として 0 を 指定した 場合、 ヒープ 上に 再配置 可能 ブロックを 作成 
し、 そこに 納めて ハンドルを A0 レジスタに 返す。 

再配置が 発生す る。 

C  の 関数 ► long  TSCellToStr  (handle  celHdl , char  *buf  fPtr , long  皿  ax, 
char  ***buf fHdl) ; 

返り 値は、 文字列の バイ ト数 または リザルト コード。 

char 型の ハンドル buffHdl には、 文字列を 納めた バッファへの ハンドルが 
格納され る。 


$A42A 


SXLockFSX 


引 数- なし 
あり 値 ►  なし 

機 能 >  SX システムを ロックす る。 

C  の 関数 ►  void  SXLockFSX  (void) ; 
返り 値は ない。 


$A42B 


SXUnlockFSX 


引 数 なし 
返り 値 ►  なし 

機 能 ►  SX システムを アンロック する。 
C  の 関数 ►  void  SXUnlockFSX  (void) ; 
返り 値は ない。 


$A42C 


TSFockMode 


弓 I  数 ►  long  f ileNamePtr  ; ファイル 名 (ASCIIZ 型） への ポインタ 

long  dFileName  ; 実際に 起動され る ファイル 名が E る バッファ 

(90 バイト） 
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返り 値 ►  D0.L 

0 

ファイルから 起動 

1 

リ ソース タイプ 'CODE， から 起動 

2 

メモリ 中の タスクを 複写して 起動 

AO.L  複写す る タスクの ID/ リソース （CODE， の ID 
機 能 ►  fileNamePtr で 指定した ファイルを $A353  TSFoc 城で 起動した 場合の 起 
動モー ドを 調べる （起動す る わけでは ない）。 dFileName と fileNamePtr は 
同じ ものを 指定しても よい。 

再配置が 発生す る。 

C  の 関数 ►  int  TSFockModei  const  char  *f  ileNamePtr ,  char  *  dFileName , 
long  幸 taskID) ; 

返り 値は、 結果を 意味す る 数値。 

int 型の 変数 taskID じは、 複写す る タスクの ID または リソース 乂 ODE， 
の ID が 格納され る。 


$A430  TSSetGraphMode 

引 数 ►  word  rmode  ; 0 の 《 外で 実 画面 モード 

word  scrMode  ; 画面 モード 

返り 値 ►  D0.L  リザルト コード 

機能 >  タスク マンを 初期化す る 際に 参照され る 画面 モードを SRAM じ 設定す る。 

scrMode は、 IOCS の _CRTM0D で 指定す る 値と 同等。 rmode として 0  U 
外を 指定す ると、 実 画面 モード じなる。 

C の 関数 ►  int  TSSetGraphModeiBDOLEM  rmode ,  int  scrMode) ; 

返り 値は リ ザル トコ ー ド。 


$A431  TSGetGraphMode 


引 数- なし 

返り 値 ►  D0.L  S 民 AM に 設定され ている 画面 モード 

上位 ワード：  01^ 外で 実 画面 モード 
下位 ワード： 画而 モード 
A0.L  グラフマンを 初期化した 値 

上位 ワード：  oia 外で 実 画面 モード 
下位 ワード： 画閒 モード 
= -1 グラフマンは 初期化され ていない 
機 能 ►  タスク マンの 画面 モードを 得る。 

C の 関数 ► long  TSGetGraphModedong  本 initValue) ; 

返り 値は SRAM に 設定され ている 画面 モード。 

long 型の 変数 initValue じは グラフマンを 初期化した 値が 格納され る。 
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$A432  SXGetDispRect 


引 数 ► long  rectPtr  ; レク タング ル レコー ドへの ポインタ 

返り 値 ►  なし 

機能 ►  rectPtr で 指定した レク タング ル レコー ドに 現在の 表示 画面を 返す。 実 画面 
モー ドの 場合、 表示 画面と 実際に 揣 画を 行う 実 画面は 異なる。 

C の 関数 ►  int  SXGetDispRect ( Re c t  れ ectPtr) ; 

返り 値は 意味を 持たない。 


$A435  SXSRAMVer 


引数 >  なし 

返り 値 ►  DO .  L  ノス ー ジョン 


0 

SX-WINDOW  1.10 副 

1 

SX-WINDOW  1.10 講 

2 

SX-WINDOW  3.00  U 降 

機 能 ►  SRAM を 初期化した SX システムの バージ ョ ンを 得る。 

C の 関数 ►  int  SXSRAMVer(void) ; 

返り 値は、 SRAM を 初期化した SX システムの バージョン。 


$A436  SXSRAMReset 


引数 >  なし 
返り 値 ►  なし 

機能 ►  SX システムが 使用す る S 民 AM 領域を 初期化す る。 
C の 関数 ►  void  SXSRAMReset (^void) ; 

返り 値は ない。 


$A437  SXSRAMCheck 


引 数 

なし 

返り 値*^ 

D0.L 

0 

自分と 同じ バージ ョ ン なので 初期化を 斤わなかった 

1 

ネリ 期 化を 斤った 

2 

自分よ り 新しい バージ ョ ン なので 初期化を 斤わなかった 

機 能 ►  S 民 AM に 記録され ている 槽 報の バージョンを 調べ、 自分より 古い 場合は 初期化 
を 巧う。 

C の 関数 ►  int  SXSRAMCheckivold) ; 

返り 値は、 結果を 意味す る 数値。 
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$A438 

TSAdiustRect 

1  S •日 

引 数- 

long 

dRectPtr  ; 

結果を 格納す るレク タング ルレ コー ドへの 
ポインタ 

long 

sRectPtr  ; 

もと じなる レ クタ ン グルレ コー ドへの ポイ 

ンタ 

返り 値 

word 

なし 

皿 ode  ; 

画面 モード 

機能- 

虹 ode 

の 画面 モー ドで sRectPtr 

を 表示した 場合の 画面の 位置を、 現在の 画 

面 モードで 表示した 場合に 換算して dRectPtr に 格納す る。 

画面 モー ド や スクロール レジスタの 状態に かかわらず、 固定した 位置に ウィン 
ドウを オープン する 場合な どに 使用す る。 
dRectPtr と sRectPtr は 同じ ものが 指定で きる。 
mode  の 値は  $A 430  TSSetGraphMode  と 同様。 

C の 関数 ►  void  TSAdjustRect (Rect  *dRectPtr ,  Rext  *sRectPtr , 

i 丘 t  皿 ode) ; 

返り 値は ない。 


$A43B  TSPostEventTskS 


引 数*^ 


返り 値 ► 
機能 > 


long  mesl 

long  皿 es2 

word  what 2 

byte  Hmodel 


メ ッセ ー ジ 1 
メ ッセ ー ジ 2 

タスク マン イベント コード 
ハン ドル モード 1 


byte  Hmode2 


word  tasKiD 

long  sizel 

long  size2 


0 

そのまま 使用 （廃棄し ない） 

1 

そのまま 使用 （廃棄す る） 

2 

コ ピーして 使用 （廃棄し ない） 

3 

コピーして 使用 （廃棄す る） 

; ハン ドル モード 2 


0 

そのまま 使用 （膽棄 しない） 

1 

そのまま 使用 （廃棄す る） 

2 

コピーして 使用 （廃棄し ない） 

3 

コピーして 使用 （廃棄す る） 

; イベントを 発を させる タスクの ID 


; 皿 esl の サイズ 
;ines2 の サイズ 


D0.L  リ ザル トコー ド 

mesl , mes2 ,  what  2 で 指定した デー タを それぞれ whom,  who 皿 2,  what  2 
に 持つ よう な タスク マン イベント レコー ドを 作成し、 taskID で 指定した タス 


クに イベントと して 発生させる。 この イ ベン トの穗 類は 12(E_SYSTEM1) に 固 
を。 
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C の 関数 • 


whom あるいは whom2 に 格納され ている 引数が ハン ドルで ある 場合、 曲 lodel あ 
るいは Hmode2 の bitl を 1 にす る、 別の ブロックを 作成して whom,  who 皿 2 
が 4 ■富す ブロ ックの 内容を コピーす る。 タスク マンの イベント キューに 登録され る 
タスク マン イ ベント レコー ドの whom,  wliom2 に は 新しく 作成 した ブロックへ 
の ハンドルが 格納され る。 bitO を 1 にした 場合、 タスク マン イベント レコ ー 
ドを 廃棄す る 際、 これらの ブロックは 同時に 廃棄され る。 
taskID に- 1 を 指定した 場合、 すべての タスクに イベントが 発生す る。 
sizel (または size2) に- 1 を 指定した 場合、 mesl (または mes2) のブ 
ロックの サイズが 用いられる。 この場合、 皿 esl (または 田 es2) は 疑似 ハンド 
ルであって はならない。 

再配置が 発生す る。 

void  TSPostEventTsk3 (Ion 良 皿 esl,  long  田 es2,  int  what 2 , int 
Hmodel , int  Hmode2,  int  taskID,  long  sizel,  long  size2) ; 
返り 値は ない。 


$A43E 


TSAnswer2 


信 O 


引 数- 


long 

mesl 

.メ ッ セージ 1 

long 

虹 es2 

; メッセージ 2 

word 

what  2 

; タスク マン イベント コード 

byte 

Hmodel 

; ハン ドル モ ー ド 1 

byte 


Hmode2 


word 

taskiD 

long 

sizel 

long 

size2 

返り 値 

DO.L 

0 

機 能 ► 

指定した 引数 じよ っ 

0 

そのまま 使用 （廃棄し ない） 

1 

そのまま 使用 （廃棄す る） 

2 

コピーして 使用 （廃棄し ない） 

3 

コ ピーして 使用 （廃棄す る） 

ハン ドル モ ー ド 2 

0 

そのまま 使用 （廃棄し ない） 

1 

そのまま 使用 （廃棄す る） 

2 

コ ピー して 使用 （廃棄し ない） 

3 

コ ピーして 使用 （廃棄す る） 

; イベントを 発生させる タスクの ID 
;mesl の サイズ 
;mes2 の サイズ 


$A417  TSAnswer で 返事を 返した 
タスク 指を イベントを 登録した 
リ ザル トコード 


スク マン イベント レコードを 作成し、 タスク 閒 通信に 
対する 返事を 返す。 $A417  TSAnswer で エラーが 発生した 場合は タスク 指定 
イベントを 登録す る。 

各 引数の 内容に ついては $A43B  TSPostEventTsk3 を 参照。 

タスクの 切 り 替えは 発生し ない。 
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再配置が 発生す る。 

C の 関数 ►  int  TSAnswer2 (long  皿 esl,long  皿 es2，i 凸 t  what2, int  Hmodel, 
int  Hmode2,  int  taskID,  long  sizel , long  size2) ; 

返り 値は、 結果を 意味す る 数値 または リ ザル トコ ー ド。 


$A443  TSErrDialogN 


引 数 ►  word  flags  ; ダイアログの 形式を 指定す る フラグ 

long  strZPtr  ; エラー/ 警告 メ ッ セージ （ASCIIZ 型） への 

ポインタ 

返り 値 ►  D0.L  アイテム 番号/リザルト コード 

機 能 ►  タスク 名 表示 かきの 備易 エラーメッセージ 用 ダイアログを 表示す る。 タスク 名 
が 表示され る la 外は $A2F6  DMError と 同様。 

再配置が 発生す る。 

C の 関数 ►  int  TSErrDialogN ( int  flags ,  const  char  *strZPtr) ; 

返り 値は、 アイテム-番号 または リザルト コード。 


$A446  TSSearchFileS 


引 数 


返り 値 
機 能- 


byte 

byte 


long 

long 

long 

long 

DO.L 


model 

mode2 


sNamePtr 

dNamePtr 

path 


； ダイアログを 表示す るまでの 検索 回数 
； 検索を 件 


0 

指定し ない 

1 

path で 指定され た パス リストと 

sNamePtr で 指定 さ れた ドライ ブ だけ 

を 検索す る 

2 

path で 指を された パス リス ト だけを 

検索す る 

; ファイル 名 （ASCIIZ 型） への ポインタ 
; 発見した ファイル 名を 格納す る バッファ （90 
バイい 

; パス リス ト 文字列 （ASCIIZ 型） への ポイ 
ンタ 


filterProc  ; フイ ルタ プロセスの アドレス 

ファイル サイ ズ / リ ザル トコ ー ド 


sNamePtr で 指定した ファイルを mode し mode2 に 従って 検索し、 発見で 


きた ファイルの 名前を dNamePtr に 返す。 sNamePtr のなかに パス カ {含まれ 
ない 場合、 々レント パスが 補われる。 


path で ポインタを 指定す る パス リストは、 1 個の I 上の パス 名を‘‘；’’ で 区切 っ 
て 並べた ASCI  口 义字 列。 path として 0 を 指定す ると、 検索 パスを 指定し 
ない こと になる。 


filterProc は、 発見した ファイルを 取捨選択 する ための 闡 数の アドレス 。閑 
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数の 仕樣は iu 下のと おり。 


int  (*f ilterProc) (const  char  幸 name,  long  ext) ; 
name は、 パスを 除いた ファイル 名への ポインタ。 
ext はお 張子。 

返り 値と して 負の 値を 返す と、 その ファイルは 発見し なかった ことじなる。 

dNamePtr は sNamePtr と 同じ ものを 指定しても よい。 

再配置が 発生す る。 

C の 関数 ► long  TSSearchFileS (BOOLEAN  model,  int  皿 ode2,  const  char 
sNemePtr ,  char  *dNamePtr ,  const  char  *path,  int 
(*ii 丄 terProc)  (const  char  *name,  long  ext)); 

返り 値は、 ファイル サイズ または リザルト コード。 


$A44B  TSNameToCode  1 3.0 


引 数 ►  long  eventNamePtr  ; イベント 名 （ASCIIZ 型） への ポイ ンタ 
返り 値 ►  DO.L  イベント コード （$9000 〜 $BFFF) 

/ リザルト コード 

機 能 ►  eventNamePtr で 指定した 名前の イベント コードを 得る。 同名の イベントが 
未 登録の 場合は 登録す る。 

再配置が 発生す る。 

C  の 関数 ►  int  TSNameToCode  ( char  *  eventNamePtr) ; 

返り 値は、 イベント コード または リザルト コード。 


$A44C  TSCodeToName  I  3.Q 


引 数 ►  word  eventCode  ; イベント コード 

long  buf fPtr  ; イベント 名 （ASCIIZ 型） が 返る バッファ 

への ポイ ンタ 

返り 値 ►  D0.L  リ ザル トコード 

機 能 ►  eventCode で 指を した イベント コー ドに 対応す る イベント 名を buf  fPtr で 
示された バッファ じ 格納す る。 

再配置が 発生す る。 

C の 関数 ►  int  TSCodeToName ( int  eventCode ,  char  *buf fPtr) ; 

返り 値は リザ ル トコ ー ド。 
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$A44D  TSNameToHdl 


引数 
返り 値 ► 


機 肯 


long  strZPtr  ;ASCIIZ 文字列への ポインタ 

D0.L  再配置 可能 ブロックへの ハンドル 


0  エラー 

<0  リ ザル トコー ド 

StrZPtr で 指定した 文字列に 対応す る ハンドルを 返す。 同名の ハンドルが 登 
緑され ていなかった 場合は 0 バイ トの 再配置 可能 ブロックを 作成し、 登録す 


る。 

再配置が 発生す る。 

C の 関数 ►  Handle  TSNameToHdl ( char  *strZPtr) ; 


返り 値は ハン ドル またはり ザル ト コード。 
エラー が 発生し た 場合、 NULL  . 力维 る。 


$A450  SXPack 


引 

数 

word 

pID 

； データ 圧縮 定義 関数の ID 

long 

srcLen 

; 圧縮 前の データの バイト 数 

long 

destPtr 

; 圧縮 後の データを 格納す る バッファへの ポ 

インタ 

long 

srcPtr 

; 圧縮 前の データへの ポインタ 

返り 値 ► 

DO.L 

圧縮 後の デー タ の サイズ/ リザ ル トコー ド 

AO.L 

destPtr 

として 0 を 指定した 場合、 データを 格納した ハンドル 

機 

能 

srcPtr 

で 指定した 

srcLen バイ トの データを、 pID で 指を した デー タ 圧縮 

定義 閱数 によって 圧縮す る。 

結果は destPtr で 指定した バッファに 格納され る。 destPtr として 0 を 
指定した 場合、 データ 圧縮 定義 関数が 再配置 可能 ブロックを 確保し、 そのな か 
で 圧縮 後の データを 格納す る。 この ハンドルは A0.L に 返される。 

再配置が 発生す る。 

C の 関数 ►  int  SXPacic(short  pID,  long  srcLen,  void  *destPtr , 
void  幸 srcPtr,  Handle  幸 destHdl) ; 

destPtr が NULL の 場合、 圧縮 データの ハン ドルは ハンドル destHdl に 格納 
される。 

返り 値は 圧縮 後の データの サイ ズ または リザ ル ト コード。 


$A451  SXUnpack 


厂 3.1 


引 数 ►  word  pID 

long  srcLen 


; データ 圧縮 定義 聞 数の ID 
; 展開 前の データの バイト 数 
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long 

destPtr 

； 展關 後の データを 格納す る バッファへの ポ 
インタ 

long 

srcPtr 

; 展關 前の データへの ポインタ 

返り 値 

DO.L 

展開 後の データの サイ ズ / リ ザル トコー ド 

AO.L 

destPtr 

として 0 を 指定した 場合、 データを 格納した ハンドル 

m 能*^ 

srcPtr 

で 指定した 

srcLen バイ トの デー タ を、 pID で 指定した デー タ 圧縮 

定義 関数 じよって 展開す る。 

結果は、 destPtr で 指定した バッファ じ 格納され る。 destPtr として 0 を 指 
定 した 場合、 データ 圧縮 定義 闕 数が 再配置 可能 ブロックを 確保し、 そのな かで 
展開 後の データを 格納す る。 この ハン ドルは AO.L に 返される。 

再配置が 発生す る。 

C の 関数 ►  int  SXUnpackishort  pID,  long  srcLen,  void  ♦destPtr ,  void 
本 srcPtr,  Handle  幸 destHdl) ; 

destPtr が NULL の 場合、 展關 データの ハン ドルは ハン ドル destHdl に 格納 
される。 

返り 値は 展開 後の データの サイズ またはり ザル トコ ー ド。 


$A452 

SXGetPackSize 

1  3.1 

引 数- 

word 

pID  ; デー タ 圧縮 定義 関数の ID 

long 

srcLen  ; 圧縮 前の データの バイト 数 

返り 値 ► 

DO.L 

圧縮 後に 予想され る 最大の サイズ 

/ リザ ル トコード 

機能- 

srcLen の サイズの データを pID で 指定す る データ 圧縮 定義 関数で 圧縮した 

場合、 

最悪の ケースで どれ だけの サイ ズの バッファが 必要 かを 返す。 

再配置が 発生す る。 

C の 関数 > 

int  short  pID,  long  src し en) ; 

返り 値は、 圧縮 後に 予想され る 最大 サイズ または リザ ル トコ ー ド。 

$A453 

SXGetCODFList 

i  3.1 

引 数- なし 

返り 値 >  DO.L  データ 圧縮 定義 関数の 数 

A0.L  配列への ハン ドル 

機 能*^ システムに 登録され ている データ 圧縮 定義 関数に 関する 情報を、 配列の 形で 再 
配置 可能 ブロック に 入れて 返す。 

配列の 1 つの レコードは、 じ I 下の ような 構造を 持つ。 
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typedef  struct  { 

short  resID; 

long  kind; 

unsigned  char  name [22j ; 
long  rsv; 

}  CODFInfo; 


/*-l のとき 終端*/ 

/* セル データの 種類を 意味す る 識別子*/ 
/*  ASCIIZ  (名前がない 場合 も ある）*/ 


データ 圧縮 定義 関数は、 システム リソースに リソース タイプ‘ C0DF’ の リソー 
ス として 用意され る。 ‘C0DF’ リソースの 内容は 単なる 閱 数で、 la 下の ような 仕 
様を 備えて いる。 

int  compactDef (short  and,  long  *argv) ; 

cm 过  : コマンド （0: 圧縮、 1: 展閒、 2: 圧縮 後の 最大 サイズ 計算） 

argv [0] : もとになる データの バイ ト数 （cmd  =  0, 1,  2) 
argvEl] : 化理 済み デー タを 普き 出す バッファへの ポインタ （cmd  =  0， 1) 
argv  [2] : 化理を 巧う デー タへの ポインタ (cmd  =  0, 1) 

返り 値は リ ザル トコ ー ド。 

データ 圧縮 定義 関数は、 ‘C 日 DF’ と 同じ ID を 持つ 情報 リソース‘ COIF’ と ペアと 
なること で システムに 認知され る。 'COIF リソース はじ 1下 の 構造を 持つ。 


typedef  struct  i 

long  kind;  /* セル データの 種類を 意味す る 識別子*/ 

unsigned  char  name  [22]  ;  /*  ASCIIZ  (名前がない 場合 も ある）*/ 

}  COIF; 


SX  WINDOW  ver.3.1 は、 SX システム 内に デフォルトの デー タ 圧縮 定義 閱数 
を 持つ （リ ソースで オーバー ライ ドす る こと も 可）。 


ID 

kind 

圧縮 アルゴリズム 

0 

CORL 

ラン レングス 圧縮 

1 

CORP 

ランレングス ピクセル 圧縮 

再配置が 発生す る。 


C の 関数 ►  int  SXGetCODFList (CODFlnfo  ***ciHdl) ; 

データ 圧縮 定義 関数に 関する 情報の 格納 さ れ てい る 再配置 可能 ブロック の ハン 
ドノ レ か*、 CODFInfo 型の ハンドル ciHdl に 格納され る。 

返リ 値は データ 圧縮 定義 関数の 数。 


$A454  SXCellToCODF 


CaT 


引 数 >  Ion 邑  kind  ; セル データの 種類を 意味す る 識別子 

返り 値 ►  D0.L  データ 圧縮 定義 関数の ID/ リザ ル トコー ド 

機 能 ►  kind で 指を された セル データの 種類から、 その セル データを 展開 可能な デー 
夕 圧縮 定義 関数の ID を 返す。 

セル リストの なかの セルの 種類が で〇??’  だった 場合、 アプリケーションは 
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この コールを 使って 展觸 可能な データ 店 縮 定義 関数を 探す ことができる。 
圧縮され た セルは、 の TF のよう な 構造を 持つ。 

typedef  struct  { 
unsigned  long 
long 

unsigned  丄 ong 
long 

unsigned  char 
}  cCell; 

このような 形式の セルを $A451  SXUnpack で展關 する 場合、 展開 前の データ 
への ポイ ンタ として data の 位置を 指定す る。 

再 配 蘆が 発生す る。 

C の 関数 ►  int  SXCell ToCODF ( 1 ong  kind) ; 

返り 値は データ 圧縮 定義 関数の ID または リ ザル トコ ー ド。 


$A4A0  TSResNew  「 己 日 


引数- なし 

返り 値 ►  D0.L  リザルト コード 

A0.L  リ ソー スマップへの ハン ドル 

機 能 ►  リソー スマップを メモリ 上に 作成し、 コー ルした タスクの リソース 系列の カレ 
ント とする。 リソース 系列が リンクされ ていない 場合は、 新しい 口ー カルリ ソー 
ス 系列を 割り当てる。 実際に ファイル が 作成 される わけでは ない。 

作成 直後の リ ソース マップの 内容は 空で ある。 

再配置が 発生す る。 

C  の 関数 ►  Handle  TSResNew  (void) ; 

返り 値は リ ソース マップへの ハン ドル。 


$A4A1  TSResOpen  f  2.0 


引 数*- long  Name  ; リソース ファイル 名 

返り 値 ►  DO.L  リ ンク した リ ソース 系列/リザルト コード 

AO.L  リ ソー スマップへの ハン ドル 

機 能 ►  Name で 指定した リソース ファイルを オ_ プン して、 コー ルした タスクの リソー 
ス 系列の カレント とする。 リソース 系列が リンクされ ていない 場合は、 新しい 
口ー カルリ ソース 系列を 割り当てる。 この 時点では リ ソース マップの みが 読み 
达 まれ、 ファイルは オープンが 態の ままで ある。 

再配置が 発生す る。 

C の 関数 ►  Handle  TSResOpen  (const  char  *Naine) ; 


kind;  /*  ‘CO??’  */ 

length;  /* 圧縮 後の サイズ*/ 
oKind;  /* 圧縮 前の セルの 種類*/ 
oLength ;  /* 圧縮 前の サイズ*/ 

data [2]  ;  /* 圧縮され た デー タ */ 


474 


タスク マン 


返り 値は リソース マップへの ハンドル。 エラーが 発生した 場合、 NULL が 返る。 


$A4A2  TSResClose  I  e.o 


引 数 ► long  Name  ; ファイル 名 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  コー ルした タスクの リソース 系列の カレント リソース マップと、 その 下の リ ソー 
ス 群を Name で 指定した ファイルに セーブして、 メモリから 削除す る。 々レン 
卜 は 次の リ ソース マップに 移る。 

再配置が 発生す る。 

C の 関数 ►  int  TSResClose ( const  char  幸 Name) ; 

返り 値は リザルト コード。 


$A4A3  TSResSave  し 呂.〇 


引 数 ►  long  Name  ; リソース ファイル 名 

返り 値 ►  D0.L  リザルト コード 

A0.L  リ ソースファイル 名が そのまま 返る 
機 自6>  コー ルした タスクの リソース 系列の々 レント リソー スマップと、 その 下の リソー 
ス 群を Name で 抱を した ファイルに セーブす る。 メモリから 削除し ない。 カレ 
ン トリ ソース マップは 変更され ない。 

再配置が 発生す る。 

C  の 関数 ►  int  TSResSave  (const  char  *Naine) ; 

返り 値は リ ザル トコ ー ド。 


$A4A4  TSResRemove  し 2.日 


引数 なし 

返り 値 ►  DO.L  リザ ル トコー ド 

機 能 ►  コールした タスクの リソース 系列の カレント リソース マップと、 その 下の リソー 
ス 群を メモリから 削除す る。 オープン 中の 場合は クローズ する。 々レントは 次 
のリ ソース マップに 移る。 

再配置が 発生す る。 

C  の 関数 ►  int  TSResRemove  (void) ; 

返り 値は リ ザル トコ ー ド。 


$A4A5  TSResLoad  |  2.0 


引 数 ►  なし 
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返り 値 ►  DO.L  リザルト コード 

機 自旨>  コールした タスクの リ ソース 系列の カレン トリ ソース マップと la 下の リ ソース 
を、 すべて 読み込んで メモリに 麗 く。 ファイルは クローズ される。 

再配置が 発生す る。 

C の 関数 ►  int  TSResLoad (void) ; 

返り 値は リ ザル トコ ー ド。 


$A4A6  TSResDispose  I  己. 〇 


引 数 なし 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  コールした タスクの リ ソース 系列の々 レン トリ ソース マップを メモリから 削除 
する。 オープン 中の 場合で も クローズ しない。 

再配置が 発生す る。 

C の 関数 ►  int  TSResDispose  (void) ; 

返り 値は リザルト コード。 


$A4A7  TSCurResGet  し 包 〇 


引 数 ►  なし 

返り 値 ►  D0.L  々レン トリ ソース マップへの ハン ドル 

A0.L  カレン トリ ソー スマップへの ハン ドル 

機 能 ►  コールした タスクの リ ソース 系列の々 レン トリ ソー スマップへの ハン ドルを 返す。 

C の 関数 ►  Handle  TSCurResGet  (void) ; 

返り 値は カレン トリ ソース マップへの ハン ドル。 


$A4A8  TSLastResGet  し 包 □ 


引数 >  なし 

返り 値 ►  D0.L  最終 リソー スマップへの ハンドル 

AO.L  最終 リ ソー スマップへの ハン ドル 

機 能 ►  コールした タスクの、 リソース 系列の 最終 リソー スマップ （最後に オープン さ 
れたリ ソース マップ） への ハン ドルを 返す。 

C の 関数 ►  Handle  TSLastResGet  (void) ; 

返り 値は、 最終 リソー スマップへの ハンドル。 


$A4A9  TSCurResSet  I  E.O 
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返り 値 ►  DO.L  リザルト コード 

AO.L  前の々 レン トリ ソー スマップへの ハン ドル 

機 能 ►  ResMap で ネ旨定 した メモリ 中の リソース マップを、 コー ルした タスクの リ ソー 
ス 系列の カレント にす る。 

リ ソース 系列に リ ンク されて いない リ ソース マップを 指定した 場合は エラーじ 
なる。 

リ ソース 系列を 共有す るすべ ての タスクで、 カレン トリ ソース マップが 変更 さ 
れ る。 

C の 関数 ►  Handle  TSCurResSet (Handle  ResMap) ; 

返り 値は、 前の カレン トリ ソー スマップへの ハン ドル。 


$A4AA 


TSRscAdd 


I 己 〇 


引 数 long 
word 
long 
long 

返り 値 ►  DO.L 
AO.L 


Type 
ID 
h 

Size 

リ ザル トコ ー ド 
新しい リ ソースへの ハン ドル 


追加す るリ ソースの タイプ 
追加す るり ソース ID 
追加す るリソ ー ス への ハン ドル 
追加す るリソ ー スの サイズ 


機 能 ►  コー ルした タスクの、 リソース 系列の カレントの リソー スマップ じ リソースを 
追加す る。 

リソースは、 リソース マンが 新しく 確保した ブロックに コピー される。 疑似 ハ 
ン ドノ レ も 可。 

再配置が 発生す る。 

C  の 関数 ►  -Handle  TSRscAdd  (long  Type ,  int  ID, —Handle  11,10 ng  Size) ; 

返り 値は 新しい リ ソース への ハン ドル。 


$A4AB 


TSRscGet 


I  E.O 


引数 long 
word 

返り 値 ►  DO.L 
AO.L 


Type 

ID 

リザルト コ ー ド 
リ ソースへの ハン ドル 


;Get したい リソースの タイプ 
;Get したいり ソース ID 


機 能 ►  コールした タスクの リソース 系列から Type と ID で 指定した リソースを 探 
し、 発見で きた 場合は ハンドルを 返す。 

再配置が 発を する。 

C  の 関数 -Handle  TSRscGet  (long  Type,  int  ID); 

返り 値は リソースへの ハンドル。 エラーが 発生した 場合は NULL が 返る。 
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$A4AC 


TSRscRemove 


I  2.0 


弓 1 数 ► long  Type  ; 削除す る リソースの タイプ 

word  ID  ; 削除す るリ ソース ID 

返り 値 ►  DO.L  リザルト コード 

機 能*"  Type と ID で 指定した リソースを、 コールした タスクの リ ソース 系列の々 レ 
ン トリ ソース マップから 削除す る。 

再配置が 発生す る。 

C  の 関数 ►  int  TSRscRemove  (long  Type ,  int  ID); 

返り 値は リ ザル トコ ー ド。 


$A4AD 


TSType 托 emove 


lao 


引 数- 
返り 値- 
機 能- 


; 削除す るり ソース 群の タイプ 


丄 ong  Type 

DO.L  リザ ル トコー ド 

コール した タスクの リ ソース 系列の々 レン トリ ソース マップの、 Type で 指を 
する タイプの リソ ース 群を すべて 削除す る。 

再配置が 発生す る。 

C の 関数 ►  int  TSTypeRemove (long  Type) ; 

返り 値は リ ザル トコ ー ド。 


$A4AE 


TSRscRelease 


弓 I 数 ► 1011 良  RscHdl  ; 民 elease する リソースの ハンドル 

返り 値 ►  DO.L  リザルト コード 

AO.L  ハン ドルが そのまま 返る （エラーの 場合は 0) 

機 自 RscHdl で 指定した リソースを、 タスク マン （ロー々 ルリ ソース マネー ジャ） の 
管理から 外し、 メモリから 削除す る。 

コー ルした タスクの リ ソース 系列に リ ンク されて いないり ソースを 指ました 場 
合は エラーになる。 

再 配 愚が 発生す る。 

C の 関数 ►  int  TSRscRelease ( .Handl e  RscHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A4AF 


TSRscDetach 


I  g.o 


引 数 ►  long  RscHdl  ; Detach する リソースの ハンドル 

返り 値 ►  DO.L  リ ザル トコード 

AO.L  ハンドルが そのまま 返る （エラーの 場合は 0) 
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機 能 ►  RscHdl で 指定した リソースを、 タスク マン （ロー々 ルリ ソース マネージャ） の 
管理から 外す。 メモリからは 削除し ない。 

コールした タスクの リ ソース 系列に リ ンク されて いない リ ソースを 指定した 場 
合は エラーになる。 

再配置が 発生す る。 

C の 関数 ►  -Handle  TSRscDetach ( .Handle  RscHdl) ; 

返り 値は、 タスク マンの 管理から 外した リソースへの ハンドル。  ， 


$A4B0  TSMaxIDGet 


Ce.O 


引 数 ► long  Type  ; 最大のを 調べる タイプ 

返り 値 ►  D0.L  Type の 最大 ID/ij ザル トコー ド 

機 能 ►  Type で 指定した リソース 群の なかで、 コールした タスクの リソース 系列 中で 
最大の ID を 返す。 

C の 関数 ►  int  TSMaxIDGet  (long  Type) ; 

返り 値は、 Type の 最大 ID または リ ザル トコ ー ド。 


$A4B1  TSHdlToRsc 


引 数 ► long  RscHdl  ; リソース マップを 得る リソースへの ハンドル 

返り 値 ►  D0.L  リソース マップへの ハンドル 

機 能 ►  RscHdl で 指定した、 リ ソース が所厲 する リソー スマップの ハンドルが 返る。 

コー ルした タスクの リ ソース 系列に リ ンク されて いない リ ソース をす 旨定 した 場 
合は エラーになる。 

C の 関数 ►  Handle  TS 打 dfTojRsc し Handle  RscHdl) ; 

返り 値は リソ ー スマップへの ハン ドル。 


$A4B2  TSResLinkGet  し 包 口 


弓 I 数 ►  long  ResMapHdl  ; リソ— スマップへの ノ 、ン ドノ レ 

返り 値 ►  D0.L  リソース マップへの ハンドル 

機 能 ►  ResMapHdl で 指ました リソー スマップの 次の リソー スマップを 返す。 
C の 関数 ►  Handle  TSResLinkGet  (Handle  ResMapHdl) ; 

返り 値は リ ソース マップへの ハン ドル。 


$A4B3  TSResRouteLink 


Cao 


引 数 ►  word  taskID 

long  route 


; タスク ID 

; リ ンク する リ ソース 系列 
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返り 値 ►  DO.L  リンク カウント/リザルト コード 

AO.L  前の リソース 系列 

德能 ►  taskID で 指定した タスクに route で 指定したり ソース 系列を リンクす る。 

taskID として- 1 を 指定す ると、 コー ルした タスクに リンクす る。 

C の 関数 ► long  TSResRou teLink ( int  taskID,  long  route) ; 

返り 値は 前の リ ソース 系列。 


$A4B4 


TSResRouteGet 


a.o 


引 数 ►  word  taskID  ; タスク ID 

返り 値 ►  DO.L  リソース 系列 

機 能 ►  taskID で 指定した タスクの リソース 系列を 返す。 

taskID として- 1 を 指定す ると、 コールした タスクの リソース 系列を 返す。 
C の 関数 ► long  TSResRouteGet ( int  taskID) ; 

返り 値は り ソース 系列。 


$A4B5 

TSRscGet2 

引 数 

long 

Type 

Get したい リソースの タイプ 

word 

ID 

Get したい リ ソース ID 

long 

route 

リ ソース 系列 

返り 値 

DO.L 

リザルト コ ー ド 

AO.L 

リ ソースへの ハン ドル 

機能- 

route 

で 指定 した リソース 系列から Type と ID で 指定した リ 

信 □ 


C の 関数 I 


し、 発見で きた 場合は ハンドルを 返す。 

再配置が 発生す る。 

.Handle  TSRscGet 2 (long  Type,  int  ID,  long  route) ; 

返り 値は リソ ース への ハンドル。 エラーが 発生した 場合は NULL が 返る。 


$A4B6 


TSRscGetS 


I  ao 


引 

数 

long 

Type  ;( 

word 

ID  ;( 

long 

route  ; 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

リ ソースへの ハン ドル 

機 

能- 

コールした タスクの 系列、 システム 

Get したい リ ソースの タイプ 
Get したい リ ソース ID 
リ ソース 系列 


定 した リ ソースが 発見で きた 場合は ハン ドルを 返す。 

SX-WINDOW  ver.3.0  U 降では、 タ スク マンが $A0E1  RMRscGet を フックし 
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て、 この コー ルと 同様の 働きを させて いる。 

再配置が 発生す る。 

C の 関数 ►  -Handle  TSRscGet3 (long  Type,  int  ID); 

返り 値は リソ ース への ハンドル。 エラーが 発生した 場合は NULL が 返る。 


$A4B7  TSResRouteUnLink  I  己 □ 


引数 >  なし 

返り 値 ►  D0.L  リンク々 ウン ト 

機 能 ► コールした タスクに リンクされ ている リソース 系列を アン リンクす る。 リンク 
カウントが 0 になった 場合、 その リソース 系列は 廃棄され、 その 下の リ ソー 
スも $A4A4  TSResRemove で 削除され る。 

再配置が 発生す る。 

C の 関数 ►  int  TSResRouteUnLink  (void) ; 

返り 値は リンク カウント。 


$A4B8  TSMaxIDGet2  し 己 口 


引 数 long  Type  ; 最大 ID を 調べる タイプ 

long  route  ; リソース 系列 

返り 値 ►  D0.L  Type の 最大 ID/ リザルト コード 

機 能 ►  Type で 指定した リソース 群の なかで、 route で 指定した リ ソース 系列のう 
ち 最大の の を 返す。 

C の 関数 ►  int  TSMaxIDGet2 (long  Type , long  route) ; 

返り 値は、 Type の 最大 ID またはり ザル トコード。 


$A4B9  TSFind  [: Ko 


引 

数 

long 

RscHdl 

; リ ソース への ハン ドル 

long 

TypePtr 

; タイプが 格納され る バッファ （1 ロング ワー 
ド） への ポインタ 

long 

IDPtr 

； ID が 格納され る バッファ （1 ワード） への ポ 

イ ンタ 

返り 値*^ 

DO.L 

リ ソース マップへの ハン ドル 

AO.L 

リ ソース マツ 

プ への ハン ドル 

機 

能 

RscHdl で ホ旨定 した リソ‘ 

-スの タイプと ID を 調べ、 それぞれ TypePtr,  IDPtr 

で 示される バッファに 格納す る。 また、 その リソース カ {属する リソース マップ 
への ハン ドルを 返す。 

コールした タスクの リ ソース 系列に リ ンク されて いない リ ソースを 指定した 場 
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合は エラー じなる。 

C の 関数 ►  Handle  TSFind ( .Handle  氏 scHdl, 101 ig  幸 TypePtr,lo 打 g  *IDPtr) ; 
返り 値は リ ソース マップへの ハン ドル。 


$A4BA  TSCurResGet2 


引 数 ► long  route  ; リソ ース 系列 

返り 値 ►  DO.L  々レン トリ ソー スマップへの ハン ドル 

AO.L  最終 リ ソース マップへの ハン ドル 

機 能 ►  route で 指定した リソース 系列の カレント リソース マップと 最終 リソース マッ 
プを 返す。 

C の 関数 ►  Handle  TSCur な esG が 2( !Long  route) ; 

返り 値は カレン トリ ソース マップへの ハン ドル。 


$A4BB  TSMaxIDGetS  1 2.0 


引 数 ► long  Type  ; リソース タイプ 

返り 値 ►  DO.L  リソース ID 

機 能 ►  コールした タスクの 系列、 システム リソ ースの 順に 検索し、 Type で 指定した 
リ ソース 群の なかで 最大の ID を 返す。 

C の 関数 ►  int  TSMaxIDGet3 (Ion 良  Type) ; 

返り 値は り ソース の。 


$A4BC  TSResFileGet 


巧 〇 


引 数- 


返り 値 ► 


機 負^ 


Ion 居  ResMapHdl  ; リソー スマ ツフ 。への ノ 、ン ドノ レ 

long  buffPtr  ; ファイル 名 （ASCIIZ 型） 力ぶ 格納され るバッ 

ファ （90 バイト） への ポインタ 
DO.L  フ アイ ルハン ドル/ リ ザル トコ ー ド 

A0.L  オープン ファイル 管理 レコー ドへの ポイ ンタ 

ResMapHdl で 指定した リソース マップの ファイル 名を buffPtr に 格納す 
る。 リソー スマップの ファイル ハンドル、 オープン ファイル 管理 レコー ドへの 

ポインタ も 返す。 


C の 関数 ►  int  TSResFileGet  (Handle  ResMapHdl , char  *buff  Ptr) ; 

返り 値は、 ファイル ハン ドル または リザ ル ト コード。 


$A4BD  TSResRouteFind 


引 数 ► long 


namePtr 


; タスク 名 （ASCIIZ 迴） への ポイ ンタ 
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long  taskID  ; タスク  ID 

long  route  ; リ ソース 系列 

返り 値 ►  D0.L  タスク ID (下位 ワードの み 有効） 

<0  該当する タスクがない 

機 能 ►  namePtr で 指定した 名前、 route で 指定した リソース 系列を 持つ タスクを、 
taskID より 大きい タスク ID の タスクの なかから 探し出す。 
namePtr として- 1 を 指を すると、 コールした タスクの 名前で 探す。 
コールした タスク は檢 索の 対象 とはなら ない。 

C の 関数 ► long  TSResRouteFind (const  char  *namePtr , int  taskID, long 
route) ; 

返り 値は、 タスク ID または 結果を 意味す る 数値。 


$A4BE  TSResTypeList 


La.o 


引 数 ► long 

argc 

； タイプの 数 力 《返る バッファ （1 ロング ヮー ド） 
のア ドレス 

Ion 良 

argv 

; タイプの リスト （タイプの 数 X 1 ロング 
ワー ド） への ハン ドルが 返る バッファの ア 
ドレス 

long 

ResMaD 

; リソー スマップの ハンドル 

返り 値 ►  D0.L 

=  0 

正常終了 

0 

エラー 

機 能 ► 指定した リソース マップに 登録され ている タイプの 数と リストを 得る。 

リストは タイプ 名 （1 ロング ワード） が タイプの 数 だけ 並んで いる 構造で、 再 配 
置 可能 ブロック として 作成され る。 末尾は 0.し リストが 不要に なったら、 廃 
棄 する 必要が ある。 

コールした タスクの、 リ ソース 系列に リ ンク されて いない リ ソースを 指定した 
場合は エラーになる。 

再配置が 発生す る。 

C の 関数 ►  int  TSResTypeList ( int  *argc,long  ***argv, Handle  ResMap) ; 
返り 値は 結果を 意味す る 数値。 


$A4BF 

TSResIDList 

1 包 日 

引 数- 

long 

argc 

; ID の 数が 返る バッファ （1 ロング ヮー ド） の 

ア ドレス 

long 

argv 

; ID の リスト （ID の 数 X 1 ワ _ ド） への ハ 
ン ドル か •返る バッファの ア ドレス 

long 

ResMapHdl 

; リソース マップへの ハンドル 

long 

Type 

; タイプ 
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返り 値 ►  DO.L  =0  正常終了 
幸 Q  エラー 

機 能 ► 指定した リ ソース マップに 登録され ている タイプの の の 数と リス トを 得る。 

リストは ID(1 ワー ド） が ID の 数 だけ 並んで いる 構造で、 再配置 可能 ブロック 
として 作成され る。 末尾は 0.W。 リストが 不要に なったら、 廃棄す る 必要が あ 
る。 

コー ルした タスクの リ ソース 系列に リ ンク されて いない リ ソース を 指定した 場 
合は エラー じなる。 

再配置が 発生す る。 

C の 関数 ►  int  TSResIDList ( int  ♦argc , short  ***argv, Handle  ResMapHdl , 
long  Type) ; 

返り 値は 結果を 意味す る 数値。 


$A4C0 

TSRscScan2 

1 3.0 

引 数 

long 

Type 

; リ ソース タイプ 

word 

start ID 

； 検索を 關始 する リソース ID 

word 

endID 

； 検索を 終了す るリ ソース ID 

word 

mode 

=  0  : 空いて いる ID を 探す 

丰り  : 使用 中の ID を 探す 

long 

route 

; リソース 系列 

返り 値 

DO.L 

リ ソース ID 

機 能- 

Type 

で 指定した リソース タイプに ついて、 route で 指定したり ソース 系列 中 

の startID から endID までの 間を 調べ、 空いて いる ID  (mode が 0 の 

場合） または 使用 中の の 

(mode が 0  U 外の 場合） を 探す。 

C の 関数 ► 

int  TSRscScan2 、 Type ,  int  start  ID,  int  endID , int  mode , 

long  route) ; 

返り 値は リ ソース の。 

ライブラリ 

TSSetAbort 

引 数*^ 

long 

procPtr 

; アボー ト 処理 ルーチンの ア ドレス 

long 

pax  am 

; アボー ト化理 ルーチンに 渡される パラメータ 

返り 値 ► 

DO.L 

前の 処理 ルーチンの ア ドレス 

機 能 ►  ハー ドウ ュア エラーが 発生した 場合に 実 斤す る アボート 化理 ルーチンを 設定す 
る。 

エラーが 発生した 場合、 exitO で 終了す る 前に アボート 処理 ルーチンが （*proc 
Ptr)  (-8194,  param) の 形で 呼び 化される。 

C 言語で コ ン パイ ルした プロ グラムで のみ 有効。 

C  の 関数 ►  int  TSSet  Abort  (void  (*procPtr)  () ,  void  *param) ; 
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プ U ン h マン 


#include  〈PRINT .H〉 


$A4E0 


PMInit 


引数 >  なし 

返り 値 ►  DO.L  リザルト コード 
機 能 ► プリント マンを 初期化す る。 

メモリ マン、 リ ソース マン、 イベント マン、 メニュー マン、 グラフマン、 ウイ 

ン ドウ マンが ネ刀期 化され、 り ソース ファイル SYSTEM. LB が オープンされ てい 
る 必要が ある。 

C の 関数 ►  int  PMInit(void) ; 

返り 値は リ ザル トコ ー ド。 


$A4E1 


PMTini 


引 数 ►  なし 

返り 値*-  D0.L  リザ ル トコー ド 

機 能 ► プリント マンの 終了 化理を 斤う < 
再配置が 発生す る。 

C の 関数 ►  int  PMTini (void) ; 


$A4E2 


PMOpen 


引 数- 
返り 値 ► 

機能- 


word 

DO.L 


ドライバの ID 


drvrID 

リ ザル トコ ー ド 

= -2  すでに ドライバが オープンされ ている 
drvrID で 指定 した の の プリンタ ドライバを、 リ ソース ‘PTRD’ から メモリ 上 
に 読み込み、 ロックす る。 drvrID と して- 1 を 指定した 場合、 SRAM じ 記録 
されて いる デフ ォル トの プリンタ ドライバが 使用され る。 

再 配 蘆が 発生す る。 

C  の 関数 ►  int  PMOpen  (int  drvrID); 

返り 値は リ ザル トコ ー ド。 
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$A4E3  PMClose 


引数- なし 

返り 値 ►  D0.L  リザルト コード 

機能 ► プリンタ ドライバの 終了 化理を 斤い、 ドライバが 使用して いた ブロックを 廃棄 
する。 

再配置が 発生す る。 

C の 関数 ►  int  PMCjose(void) ; 

返り 値は リ ザル トコ ー ド。 


$A4E4  PMSetDef ault 


弓 I 数 ►  long  prRecHdl  ; 印厢 ij 環境 レコードへの ハンドル 

返り 値 ►  D0.L  リ ザル トコ ー ド 

A0.L  印刷 環境 レコ ー ドへの ハンドル 

機能 ►  prRecHdl で 指定し た 印刷 環境 レコード に デフォルト の 値 （リ ソース ‘PrEV’ 
の の 0 に 記録され ている、 あるいは ドライバ 自体が 保持して いる） を セット 
する。 

再配置が 発生す る。 

C の 関数 ►  int  PMSetDefault ( Pr int  **prRecHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A4E5  PMValidate 


引 数 ► long  prRecHdl  ; 巧 刷 環境 レコー ドへの ハンドル 


返り 値 ►  D0.L 

0 

調整せ ず、 レコー ドの 内容に 変化は ない 

1 

調整を 斤った 

-1 

エラー 

機能 ►  prRecHdl で 指定した 印刷 環境 レコードの 内 容が正 しいか どうかを チェックし、 
調整す る。 

C の 関数 ►  int  PM Vaiidate (Print  **prRecHdl) ; 

返り 値は 調整 結果を 意味す る 数値。 


$A4E6  PMImageDialog 


引 数 ►  long  prRecHdl  ; 印 脚 J 環境 レコードへの ハンドル 


返り 値 ►  DO.L 

0 

レコ ー ドの 内容に 变化 はない 

1 

設定を 斤った 

-1 

エラー 
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機能- ページ 印刷用の 印刷 環境 設定 ダイアログを オープンし、 ユーザの 操作を 受けが 
けた あと、 クローズ する。 その 結果を もとに prRecHdl で 指を した 印刷 環境 レ 
コー ドの 内容を 設定す る。 

再配置が 発生す る。 

C の 関数 ►  int  PMImageDialog (Print  **prRecHdl) ; 

返リ 値は 設定 結果を 意味す る 数値。 


$A4E7  PMStrDialog 


引 数 ► long  prRecHdl  ; 印刷 環境 レコードへの ハンドル 


返り 値 ►  DO.L 

0 

レコードの 内容に 変化は ない 

1 

設定を 斤った 

-1 

エラー 

機 能 >  コード 印刷用の 印刷 環境 設定 ダイアログを オープンし、 ユーザの 操作を 受け 付 
けた あと、 クロー ズ する。 その 結果を もとに prRecHdl で 指定した 巧 刷 環境 レ 
コードの 内容を 設定す る。 

再配置が 発生す る。 

C  の 関数 ►  int  PMStrDialog  (Print  **prRecHdl) ; 

返り 値は 設定 結果を 意味す る 数値。 


$A4E8 


PMJobDialog 


1 3.0 


引 数  >  long 
返り 値 ►  DO.L 


DrRecHdl 


； 印刷 環境 レコー ドへの ハンドル 


1 

設定 

2 

取消 

-1 

エラー 

機能- 印刷 關始- 終了 ページ、 巧 刷 枚数の 設 を、 カラー 巧 刷、 ドラフト 印刷に 関する 
設定を 斤う ダイアログを 表示す る。 

C の 関数 ►  int  PMJobDialogCPrint  **prRecHdl) ; 

返り 値は 結果を 意味す る 数値。 


$A4E9  PMEnvCopy 


引 数- 


返り 値 ► 


機肯！ 


long  srcHdl  ; コピー 元の 印刷 環境 レコー ドへの ハンドル 

long  dstHdl  ; コピー 先の 巧 刷 環境 レコー ドへの ハンドル 


0 

調整を 斤わなかった 

1 

調整を 巧った 

-1 

エラー 

srcHdl で 指定した 巧 刷 環境 レコー ドの 内容を dstHdl で 指定した レコードに 
コピーす る。 その 際、 値の チ ユックと 調整が 斤 われる。 


487 


フリン h マン 


C の 関数 ►  int  PMEnvCopy (Print  **srcHdl,  Print  **dstHdl) ; 
返り 値は 調整 結果 を 意味す る 数値。 


$A4EA  PMJobCopy 


引 数 
おり 値 ► 

機 能 


long  srcHdl  ; コピー 元の 巧 刷 環境 レコードへの ハンドル 


long 

D0.L 


dstHdl  ; コピ ー 先の 巧 刷 環境 レコ ー ドへの ハンドル 


0 

調整を 斤わなかった 

1 

調整を 斤った 

-1 

エラー 

srcHdl で 指定した 印刷 環境 レコードの 実行 部々 の データを、 dstHdl で 指を 


した レコードに コピー する。 その 際、 値の チェックと 調整が 斤 われる。 


実行 部分とは、 具体的には 巧 刷 開始 ページ （prFstPage)、 印刷 終了 ぺージ 
(prLstPage)、 1 ぺージ あたりの 巧 刷 枚数 （prDupPeige) 、 印刷 モード （pr 
Mode)、 巧 刷モー ドの マスク （prMask)、 そして システム 予約 （prJobRsv) 
を 意味す る。 


C  の 関数 ►  int  PMJobCopy  (Print  **srcHdl,  Print  **dstHdl) ; 
返り 値は 調整 結果を 意味す る 数値。 


$A4EB  PMOpenImage 


引 数 ► long  prRecHdl  ; 印刷 環境 レコー ドへの ハンドル 

返り 値 ►  D0.L  リ ザル トコ ー ド 

A0.L  グラフ レコー ドへの ポイ ンタ 

機 能 ►  ページ 印刷用の グラフ レコードを 作成し、 ページ 印刷を 開始す る。 
再配置が 発生す る。 

C の 関数 ►  Graph  *PMOpenImage (Print  幸* prRecHdl) ; 

返り 値は グラフ レコードへの ポイ ンタ。 


$A4EC  PMRecordPage 


引 数 ► long  rectPtr  ; 印刷 範 脚を 意味す るレク タング ルレ コード 

への ポイ ンタ 

返り 値 ►  DO.L  リザルト コード 

機 能 ►  ページ 印刷の スクリプトの 記録を 關始 する。 rectP かで 指定した 範囲が あとで 
印刷され る。 

巧 配置が 発生す る。 

C の 関数 ►  int  PMRecordPage ( Re c t  *rectPtr) ; 

返り 値は リ ザル トコ ー ド。 
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$A4ED  PMPrintPage 


引 数 ► long  par  am  ; 必ず 0 を 指定す る 

返り 値 ►  D0.L  リザ ル トコー ド 

機能 >  ページ 印刷用 スクリプトの 記録を 終了し、 実際の 印刷を 開始す る。 
再配置が 発生す る。 

C  の 関数 ►  int  PMPrintPage  (void) ; 

引数を 指定す る 必要は ない。 

返り 値は リ ザル トコ ー ド。 


$A4EE  PMCancelPage 


引数- なし 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 >  ページ 印刷用 スクリプトの 記録を 中止す る。 巧 刷は 斤 われない。 
再配置が 発生す る。 

C の 関数 ►  int  PMCancelPage(void) ; 

返り 値は リザ ル ト コード。 


$A4EF  PMAction 


引 数 ►  word 


返り 値 ►  D0.L 


Ctrl  ; 動作の 指定 


0(PC_STAT) 

印刷を 続行す る 

KPC.END) 

印刷を 終了す る 

2(PC_ST0P) 

巧 刷を 中断す る 

3(PC.C0NT) 

巧 刷を 再關 する 

結果 


0(P_FINISH) 

巧 刷が 終了した 

1(P_W0RKING) 

印刷 中 

2(P_RESTING) 

印刷を 中断した 

3(P_TIME0UT) 

タイム アウ ト 発生 

-KP.ERROR) 

エラー 発生 

機 能 ►  印刷 化理を 斤う。 Ctrl で 指定した 動作を 巧い、 その 結果を 返す。 
再 白 己 置が 発生す る。 

C  の 関数 ►  int  PMAction  (int  Ctrl); 


返り 値は 実行 結果。 


$A4F0  PMCloselmage 


引 数 なし 
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返り 値 ►  DO.L  リザルト コード 

機 能 >  ページが 刷を 終了し、 グラフ レコード などを 廃棄す る。 
再配置が 発生す る。 

C の 関数 ►  int  PA す C7ose む na が （void) ; 

返り 値は リ ザル トコ ー ド。 


$A4F1 

PMDrawString 

引 数 ► long 

prRecHdl 

; 印刷 環境 レコ ー ドへの ハンドル 

long 

strHdl 

; 文字列への ハン ドル 

long 

length 

; 文字列の バイト 数 

long 

StrOpt 

; 印刷 オプション 

印刷 終了 時に 改 ページ コードを 出力す 
る 

印刷 終了 時に 改 ページ コードを 出力し 
ない 


返り 値*^  D0.L  リザルト コード 
機能 ►  strHdl,  length で 指定した 文字列の コ’ 
再配置が 発生す る。 


ド 印刷を 開始す る C 


C の 関数 ►  int  PMDrawString ( Pr int  **prRecHdl,  char  **strHdl, 
long  length,  int  strOpt) ; 

返り 値は り ザル トコ ー ド。 


$A4F2  PMVer 


引 数*^ なし 

返り 値 ►  D0.L  バ ージョ ン 番号 （バー ジョン 1.00 で $0100) 

機 能 ►  プリ ント マンの バージョンを 返す。 

C の 関数 >  int  PMVe バ void); 

返り 値は バージ ョ ン 番号。 


$A4F3  PMDrvrVer 


引 数 なし 

返り 値*^  D0.L  バ ージョ ン 番号 （バージョン 1.00 で $0100) 

= -1 プリンタ ドライバが 才 ープン されて いない 
機能 ►  現在 オープンされ ている プリンタ ドライバの バージョンを 返す。 
C  の 関数 ►  int  PMDrvrVer  (void) ; 

返り 値は バー ジョ ンを 号。 
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$A4F4  PMDrvrCtrl 


引 数 ►  い ng  cmd 

long  pax  ami 

long  param2 

long  paramS 

返り 値 ► 

機能 > 

C の 関数 > 


ドライバに みえる コマンド 
パラメータ 1 
パラメータ 2 
パラメータ 3 


D0.L  リザルト コード 

プリンタ ドライバを 直接 制御す る。 プリンタ ドライバに みえる コマンド、 パラ 
メータに ついては 『追 補 版 SX-WINDOW プログラミング J 本文 参照。 
int  PMDrvrCtrl ( int  cmd,  •  •  •) ; 


返り 値は リ ザル トコ ー ド。 


$A4F5  PMDrvrID 


引 数 なし 

返り 値 ►  D0.L  プリンタ ドライバの ID (下位 ワー ドの み 意味を 持つ） 
= -1 プリンタ ドライバが オープンされ ていない 
機 能  >  現在 オープンされ ている プリンタ ドライバの ID を 返す。 

C の 関数 ►  int  PMDrvrID  (void) ; 

返り 値は プリンタ ドライバの ID。 


$A4F6  PMDrvrHdl 


引数 >  なし 

返り 値 ►  D0.L  リ ザル トコ ー ド 

= -1 プリンタ ドライバが オープンされ ていない 
A0.L  フ 。リン タ ドライバへの ハン ドル 

機 能 ►  現在 才ー プン 中の プリ ンタ ドライバが 納められ ている ブロ ッ ク への ハン ドルを 
返す。 

C の 関数 ►  Handle  PMDrvrHdl  (void) ; 

返り 値は プリンタ ドライバへの ハン ドル。 

エラー の 場合は NULL が 返る。 


$A4F7  PMMaxRect 


弓 I  数 ► long  prRecHdl 

word  pKind 

long  rectPtr 


; 巧 刷 環境 レコ ー ドへの ハンドル 
; 用紙の 種類 

; 結果が 返る レ クタ ン グル レコー ドへの ポイ 
ンタ 
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返り 値 ►  DO.L  リザルト コード 

A0 .  L  巧 刷 環境 レコ ー ド への ハンドル 

機 能 ►  pKind です 旨定 した 用紙の 印刷 可能な 最大 範圃 を、 rectPtr で 指定した レ クタ 
ン グル レコー ド じ 返す。 

C の 関数 ►  int  PMMaxRect (Print  幸* prRecHdl, int  pKind ,  Rect 
幸 rectPtr) j 
返り 値は リ ザル トコ ー ド。 


$A4F8  PMSaveEnv 


引 数 ► long  prRecHdl  ; 印刷 環境 レコー ドへの ハンドル 

返り 値 ►  D0.L  リ ザル トコー ド 

機能 ►  prRecHdl で 指ました 印刷 環境 レコードの 内容を デフォルトの 値と して リソー 
ス fPrEV， の ID  0 じ 記録す る。 

再 配 愚が 発生す る。 

C の 関数 ►  int  PMSaveEn v ( Pr i nt  **prRecHdl) ; 

返り 値は リ ザル トコー ド。 


$A4F9  PMReady 


引数- なし 

返り 値 ►  D0.L  プリンタ のが 態 


0(PS_BUSY) 

印刷 不可 

KPS.READY) 

印刷 可 

機 能 >  プリンタ のが 態を 調べ、 結果を 返す。 

C  の 関数 ►  int  PMReady  (void) ; 

返り 値は プリ ンタの 状態を 意睐 する 数値。 


$A4FA  PMProcPrint 


引 数 ►  long  prRecHdl  ; 巧 刷 環境 レコードへの ハンドル 

long  procPtr  ; ユーザ プロセスの ア ドレス 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 >  procP れで 指定した ューザ プロセスを 登録し、 プロセス 印刷を 開始す る。 
C  の 関数 ►  int  PMProcPrint  (  Pr  int  **prRecHdl, 

int  (幸 procPtr) (Print  **prRecHdl，  Rect  れ ectPtr)); 

返り 値は リ ザル トコ ー ド。 
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$A4FB 

PMDrvrInfo 

引 数 ► 

word 

drvrID 

; プリンタ ドライバの ID 

long 

prdrInfoPtr 

; プリンタ ドライバ 情報 レコードへの ポインタ 

返り 値 ► 

DO.L 

り ザル トコ ー ド 

AO.L 

prdrINf oPtr 

(AO)  .w プリンタ ドライバの ID 
2  (AO)  .w プリンタ ドライバの バージョン 
4 (AO)  プリンタ 名 (ASCIIZ) 


機能 ►  drvrID で 指定した プリンタ ドライバ に関する 情報を、 prdrInfoPtr で 指定 
した プリンタ ドライバ 情報 レコードに 返す。 か vrID と して- 1 を 指定す ると、 
デフォルトの プリンタ ドライバの 情報が 返る。 

C の 関数 ►  int  PMDrvrInfo ( int  drvrID,  PrtDInf  o  *prdrlnf  oPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A4FC  PMGetDefDlog 


Cao 


引 数 ►  word  dKind 


返り 値 ► 

D0.L 

1 

正常終了 

-1 

エラー 

； ダイアログの 種類 

0(PDL_IMG)  I— イメージ ダイアログ 
1 (PD し JOB)  ジョブ ダイアログ 


A0.L  デフ オルト ルーチンの ア ドレス 


機能 ►  $A4E6  PMImageDialog、 または $A4E8  PMJobDialog で 表示され る ダイア 

ログの 化理を 斤う デフォルトの ルー チンの ア ドレスを 返す。 

C の 関数 ►  PrDlog  *PMGetDefDlog( int  dKind) ; 

返り 値は デフォルト ルーチンの ア ドレス。 

エラー が 発生し た 場合、 NULL 力ぶ 返る。 


$A4FD  PMSetRange 


Cao 


引 数 


返り 値 ► 


機 能 ► 


long 

prRec 扫 dl 

word 

topRange 

word 

endRange 

DO.L 

1 

正常終了 

-1 

エラー 

; 印刷 環境 レコ ー ドへの ハンドル 
; 印刷 開始 ページ 数 
; 印刷 終了 ページ 数 


prRecHdl で ホ旨定 した 广: 円厮 J 環境 レコードに、 topRange と endRange です 育定 
し た 印刷 開始 ページと 印刷 終了 ペー ジを 設定す る。 


topRange  は  prMinPage  に、 endRange  は  prMaxPage  に 格納され る。 
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C の 関数 ►  int  PMSetRange ( Pr Re c  **prRecHdl, int  topRange, 
int  endRange) ; 

返り 値は 結果を 意味す る 数値。 


$A4FE  PMPutID  [~3]〇 


引 数 ►  word  CPDFID  ; 々ラー 変換 モジ ュー ルの ID 

返り 値 ►  D0.L  前の カラー 変換 モジュールの ID 

= -1  エラー 

機 能 ►  印刷 時に 使用す る デフォルトの々 ラー 変換 モジュールの ID として CPDFID を 
セットす る。 この 値は、 リ ソース fPrEV， の の 1 に 記録され る。 

CPDFID と して - 1 を 指定す ると、 現在 設定され ている ID を 返す のみと なる。 
C の 関数 ►  int  PMPutID  (int  CPDFID) ; 

返り 値は々 ラー変換 モジ ュー ルの ID。 


フリン h マン 
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フォン b マン 


#include  <SXGRAPH.H> 


$A500 


FMInit 


I  2.0 


引 数 なし 


返り 値 ►  DO.L 

0 

常駐して いる 

-1 

常駐して いない 

機 能 ►  IFM.X の 常駐 チて ックを 斤う。 
C  の 関数 ►  int  FMInit  (void) ; 

返り 値は 常駐 チて ックの 結果。 


フォン ト マンの 初期化は 巧わない。 


$A501 


FMTini 


I  E.O 


引 数- 

なし 

返り 値 ► 

DO.L 

0 

常粧 している 

-1 

常粧 していない 

機能- 

使用禁止 コ 

—ル < 

) 

IFM.X の 終了 処理を 行う が、 常駐 解除され る わけでは ない。 


$A502 


FMGetFontList 


I 己 日 


引数 なし 

返り 値 ►  DO.L  フォント リストへの ポインタ 

機 能 ►  フォント マンに 登録され ている フォントの リストを 返す。 フォント リストの 構 
造は の 《下 のと おり。 


国 


type 过 ei  struct  FontList  { 
short  id; 

short  type ; 

short  皿 other ID; 

char  Font Name [26] ; 

}  FontList ; 


/* フォント ID  */ 

/* フォント タイプ 全角: 1 半角: 0  */ 
/幸 マ ザ— ID  */ 

/* フォント 名*/ 


C の 関数 ■ 


フォント リス トが 必要な く なった 場合、 $A02F  MMPtrDispose で 廃棄す る必 
要が ある。 再配置が 発生す る。 

FontList  *  FMGetFontList  (void) : 
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返り 値は フォント リストへの ポイ ンタ。 


$A503  FMSetChacheSize 


巧 日 


引 数 ► long  chacheSize  ; フォント キャッシュの サイズ （K バイト 単位） 

返り 値 ►  D0.L  変更 後の フォン ト キャッシュの サイズ （K バイ ト 単位） 

機 能 ►  フォント キャッシュの サイズを cacheSize で 指を した 値に 設定す る。 フォン 
ト キャッ シュの 内容は 失われる。 

再 配證が 発生す る。 

C の 関数 ►  int  FMSetCacheSize ( int  cacheSize) ; 

返り 値は フォン ト キャッシュの サイズ。 


$A504  FMGetChacheSize 


引数 ►  なし 

返り 値 ►  D0.L  フォン ト キャッシュの サイズ （K バイ ト 単位） 
機 能  >  現在の フォント キャッシュの サイズを 返す。 

C の 関数 ►  int  FMGet CacheSize  (void) ; 

返り 値は フ オン ト キャッシュ の サイズ。 


$A505  FMSetSDaceWidth 


引 数 ► long  spaceWidth  ; スペースの 幅 （固定 小数点 数） 

返り 値 >  D0.L  現在の スペースの 幅 （固定 小数点 数） 

機 能 ►  スペースの 幅を、 spaceWid ■比で 指を した 値 【こ 設定す る。 spaceWidth は 文 
字の 縦 サイズとの 比率を 固定 小数点 数で 表現した もので、 整数 部 22 ビット、 小 
数 部 10 ビット （つまり、 倍率を 1024 倍した 数を 指定す る）。 デフォルトは 256。 
負の 値 も 指定 可能。 

半角 スぺ ースは spaceWidth で 指定した 幅に、 全角 スぺ ースは その 倍の 幅に 
なる。 

C の 関数 ►  int  FMSetSpaceWidth ( int  spaceWidth) ; 

返り 値は スペースの 幅。 


$A506  FMGet SpaceWidth 


Lao 


引 数 ►  なし 

返り 値 ►  D0.L  现 在の スペースの 幅 （圃を 小数点 数） 

機能 ►  現在の スペースの 幅を 返す。 
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C の 関数 ►  int  FMGetSpaceWidthivold) ; 

現在の スペースの 幅。 


フォン h マン 


$A507  FMSetTracking  1 己 〇 


引 数 ► long  trackWidth  ; トラ ッ キン グ幅 

返り 値 ►  D0.L  現在の トラッキング 幅 

機 能 ►  トラッキング 幅を trackWidth で 指定した 値に 設定す る。 trackWid なは ドッ 
卜 単位で 指定し、 負の 数 も 指定 可能。 

C  の 関数 ►  int  FMSet  Tracking  (int  trackWidth) ; 

返り 値は 現を の トラ ッ キン グ 幅。 


$A508  FMGetTracking  I  己 •日 


引数- なし 

返り 値 ►  D0.L  現在の トラッキング 幅 
機能 ► 現在の トラッキング 幅を 返す。 

C の 関数 ►  int  FMGetTracking  (void) ; 

返り 値は 現在の トラ ッ キン グ 幅。 


$A509  FMGetKerningWidth  I  包 日 


引 数 ►  word  bef oreChar  ; 直前の 义 字の コード 

word  cur  Char  ; 現在の 义 字の コード 

返り 値 ►  D0.L  2 义 字間の々ー ニン グ幅 

機 能 ►  beforeChar と ciirChar の 2 つの 英文 字間の カー ニン グ 幅を 返す。 カレント 
グラフ レコードの フォント々 インド、 フォント サイズが 参照され、 カー ニン グ 
憎 報が 用 意され ている フォントを 使用して いる 場合に のみ 正しい 値 力 《返る。 

C の 関数 ►  int  FMGetKerningWidth  (unsigned  short  bef  oreChax, 
unsigned  short  cur Char) ; 

返り 値は カー ニン グ 幅。 


$A50A  FMFontMenuSelect  |  s.o 


引 数 long  pt  ; を ボタンが 押された 座標 （グロー バル 座標 

系） 

返り 値 DO.L  選が された フォントの ID 

機 能*^  pt で 指定した ポイ ント から 現在 登録され ている フォント を 選択す る メニューを 
表示し、 選が された フォン トの ID (ニ フォン トカイ ン ド） を 返す。 


フ オン h マン 
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フォント 7 ン 


再 配證が 発生す る。 

C の 関数 ►  int  FMFontMenuSelect (LPolnt  pt) ; 
返り 値は 選が された フォントの の。 


$A50B  FMGetF ontPolyDat  a 


Ls.o 


引 数 ►  word  ch  ; 义 字の コード 

返り 値 ►  D0.L  ニュー ポリゴン レコー ドへの ポインタ 

機 能 ►  ch で 指定した 文字を ニュー ポリゴン 形式に 変換して 返す。 カレント グラフ レ 
コー ドの フ ォン ト 々インド、 フォント サイ ズが 参照され る。 

再 配證が 発生す る。 

C の 関数 ►  NPoly  *FMGetFontPolyData ( int  ch) ; 

返り 値は ニュー ポリ ゴン レコー ドへの ポイ ンタ。 


セ 7 フオ 7 ン 


セ 7 フオ 7 ン 


$A5F0 


SXI 打 itSemaphore 


3.0 


引数- 
返り 値 
機 能 > 


C の 関数 I 


なし 

なし 

セマフォ 管理 テーブルを 初期化す る。 

SX シェル カ、 •初期化す るので、 シェル 上で 動作す る アプリケーションは 使用す る 
ことができない。 

void  SXInitSemaphore ; 

返り 値は ない。 


$A5F1 


SXAddSe 虹 aphore 


3.0 


引 数 ► long  key 


; セマフォの キー となる ASCIIZ 文字列への 
ポインタ 


返り 値 ►  DO.L 


other 


すでに その キーは 登録済み 
ェ ラー 

セ マフ  ォの  ID 


機能 ►  ASCIIZ 文字列 key をキー として 登録す る。 
C の 関数 ►  int  SXAddSemaphore ( char  *key) ; 
返り 値は 結果を 意味す る 数値。 


$A5F2 


SXDelSemaphore 


3.0 


引数 ► 1011 長 

key 

long 

ID 

返り 値 ►  DO.L 

1 

削除 成功 

0 

キーは 未 登録 

<0 

エラー 

; キーと なる ASCIIZ 文字列への ポインタ 
; $A 己 F1 SXAddSe 皿 aphore で 得られた セ 
マフ ォの ID 


機能 ►  ASCIIZ 文字列 key で 指定 した キーを 削除す る。 

C の 関数 ►  int  SXDelSemaphore ( char  *key ,  int  ID); 
返り 値は 結果を 意味す る 数値。 


た フフ オミ 
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セ 7 フオ 7 ン 


$A5F3  SXFindSemaphore  I  3.0 


引 数 ► long  key  ; キーと なる ASCIIZ 文字列への ポインタ 


返り 値 D0.L 

1 

登録され ている 

0 

登録され ていない 

機 能 ►  key で 指定した 文字列が 登録され ている かどう かを 調べる。 
C の 関数 ►  int  SXFindSemaphore ( char  *key) ; 

返り 値は 結果を 意味す る 数値。 


它 7 フス 7 ン 
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カラーマン 


カラー マン 


$A600  CLInit 


Cao 


引 数- 
返り 値 


機能 


なし 


1 

正常終了 

-1 

エラー 

々ラーマンの 初期化を 斤う。 


メモリ マン、 リソース マン、 グラフマンが 初期化され ている 必要が ある。 
C の 関数 ►  int  CLInit  (void) ; 

返り 値は 結果を 意味す る 数値。 


$A601  CLTini 


E3.0 


引 数- なし 
返り 値 ►  D0.L 


1 

正常終了 

-1 

エラー 

機 能*^ 々ラーマンの 終了 化理を 斤う。 
C の 関数 ►  int  CLTini  (void) ; 

返り 値は 結果を 意味す る 数値。 


$A602  CLNewPalet 


rwb 


引 数 ►  word 

long 

返り 値 ►  D0.L 
A0.L 


pKind 


皿 axWum 


1 

正常終了 

-1 

エラー 

パレ ッ ト ハン ドル 


； パレ ッ トの 種類 

0  (CLK-WITHLIST)  々ラー リスト あり 
_ 1 _(CLK_NOLIST)  __ カラーリ ストな し 

； カラーの 数 （1 〜 102 4) 


エラーの 場合は 0 

m 能 ►  pKind で 指定した 種類で、 皿 axNum で 指ました 数の 色を 表現す るた めの 新し 
い パレ ッ ト ハン ドルを 作成す る。 

作成され た パレ ッ ト ハンドル じは、 じ [下の ような 値が 設定され る。 


paletDev  0(CDEV_N0NE) デノ 、•イスに リンクされ ていない 
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paletDepth  -1 


ピクセルの 深さは X680x0 形式 （5+5+5+1 
bit) 

ピクセ ルの 並びは X680x0 形式 （G + 民 十 B 十 i) 


paletOrder  — 1 

「々ラー リスト あり」 を 指定した 場合、 すべての カラーの々 ラー レコードに はじ I 
下の ような 値が 設定され る。 

ciRGB  すべての 要素が $0000 

ciLevel  $0000 
ciRange  $2000 

再配置が 発生す る。 

C の 関数 ►  Palet  *  *  CLNewPalet  ( int  pKind,  int  皿 axNum) ; 

返り 値は パレ ッ ト ハン ドル。 

エラー が 発生し た 場合、 NULL 力ぶ 返る。 


$A603  CLRef er  I  3.0 


引数- 

word 

rscID 

; ハ。 レット リ ソース （TALT，） のリ ソース ID 

返り 値*^ 

D0.L 

1 

正常終了 

-1 

エラー 

AO.L  パレ ッ ト ハン ドル 


エラーの 場合は 0 

機 能 ►  rscID で 指定した パレット リソ ースを 参照し、 パレット ハンドルを 作成す る。 
SYSTEM.  LB じ 用意され ている パレット リ ソースは じ [下のと おり。 


-128 

(PALT.Gie) 

グラフィック 16 色 

-129 

(PALT_G256) 

グラフィック 256 を 

-130 

(PALT_G65536) 

グラフィック 65536 色 

1 

(PALT-TEXT) 

テキス ト タイプ 

3 

(PALT-MONO) 

モノクロ 

4 

(PALT_RGB8) 

民 GBS 色 

16 

32 色 （未使用） 

17 

64 色 （未使用） 

18 

128 を （未使用） 

再配置が 発生す る。 

C の 関数 ►  Palet  **CLRefer( int  rscID) ; 

返り 値は パレ ッ ト ハン ドル。 

エラ ーが 発生し た 場合、 NULL 力ぶ 返る。 


$A 604  CLDupDevicePalet 


引 数 ►  word  cDevID 


; 々ラー デバイス ID 
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-1 

(CDEV_USER) 

ユーザ 定義 

0 

(CDEV_N0NE) 

デバイス じ リンク さ 

れ ていない 

1 

(CDEV.TEXT) 

テキスト 画面 

2 

(CDEV.GRAPH) 

グラフィック 画面 

3 

(CDEV_M0N0) 

モノクロ 

4 

(CDEV_RGB8) 

RGBS  色 

1 

正常終了 

-1 

エラー 

AO.L  パレ ツ ト ハン ドル 

エラーの 場合は 0 

機 能 ►  cDevID で 指定した デノ 、•イス パレ ッ トと 同じ 内容の パレ ッ ト ハンドルを 作成す 


る。 

再配置が 発生す る。 

C の 関数 ►  Palet  *  *  CLDupDevicePalet  ( int  cDevID) ; 

返り 値は パレ ッ ト ハン ドル。 

エラー が 発生した 場合 NULL が 返る。 


$A605  CLDisposePalet 


113.0 


引 数 
返り 値 


機能- 


long 

DO.L 


pa 丄 etHdl 


1 

正常終了 

-1 

エラー 

; ノ 、。レツ トノ 、ン ドノ レ 


paletHdl で 指ました パレ ッ ト ハン ドルを 廃棄す る。 
この コールの あと、 割り付け 変更 イベントを 登録す る。 


C の 関数 ►  int  CLDisposePalet ( P al e t  **paletHdl) ; 
返り 値は 結果を 意味す る 数値。 


$A606  CLSetCInfo 


Eao 


弓 I  数 ► long  paletHdl 

long  flags 


long  palNo 

long  number 


; パ レツ ト ハン ドル 

； 設定を 斤う 要素を 意味す る フラグの 集合体 


bitO 

赤 

bitl 

緣 

bit2 

ホ- 

bits 

アルファ 

bit4 

優 化 レベル 

bits 

レンジ 

； 設定 状況を 行う パレ ッ ト 番号 
； 設定 状況を 斤う パレット 数 
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long  cInfoPtr  ; 設定 撇兒 する 情報を 収めた カラー 情報 レコ ー 

ドへの ポイ ンタ 


0 

パレ ッ トの 削り かけに 变更 がなかった 

1 

自分 じがし、 ハ。 レッ トの 割り付けの 変更が あった 

2 

自分に 1外 じがし、 パレ ッ トの 割り かけの 変更が あった 

-1 

エラー 

機 能 ►  paletHdl で 指定した パレット ハンドル 中の、 palNo から 始まる number 個 
の パレット にがして、 cInfoPtr で 指定した 情報の flags で 示された 要素を 
設定す る。 

パレット の 割り付け じ 変更が 生じる 場合が ある。 

C の 関数 ►  int  CLSetCInfo ( P al e t  幸* paletHdl, int  flags ,  int  palNo , 
int  number ,  CInfo  *clnf oPtr) ; 

返り 値は 結果を 意味す る 数値。 


$A607  CLGetCInf 0 


E3.0 


引 数 ► long 
long 


paletHdl 

flags 


long  pa 丄 No 

long  number 

long  cInfoPtr 


返り 値 

D0.L 

1 

正常終了 

-1 

エラー 

; パレ ツ ト ハンドル 

; 設定 状況を 得る 要素を 意味す る フラグの 集 
合体 


bitO 

ホ 

bitl 

綠 

bit2 

主 

bits 

アルファ 

bit4 

優先 レベル 

bits 

レンジ 

設 をが 況を 得る パレ ッ ト 番号 
設定が 況を 得る パレット 数 
設定す る 情報を 格納す る々 ラー 情報 レコ ー 
ドへの ポイ ンタ 


機 能 ►  paletHdl で 指定した パレ ッ ト ハン ドル 中の、 palNo から 始まる number 個 
の パレ ッ ト について、 flags で 示された 要素の 設定が 況を cInfoPtr で 指定 
した カラー 情報 レコードに 格納す る。 

number として 2  UJi を 指定した 場合、 最後の パレ ッ トに閱 する 情報が カラー 
情報 レコードに 格納され る。 


C の 関数 ►  int  CLGetCInfo(Pa.let  **paletHdl,  int  flags,  int  palNo , 
int  number ,  CInfo  *cInfoPtr) ; 

返り 値は 結果を 意味す る 数値。 
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$A608  CLAlloc  rao 


引数 ► long 
返り 値*^  DO.L 


機 能 ►  paletHdl で 指定した パレット ハンドル 中の、 デバイスに 割り付けられ ていな 
い々 ラーの 割り付けを 斤う。 ガイド パレット Ja 外を 指ました 場合、 エラーが 発 
生す る。 

パレット の 割り 付けに 変更が 生 じる 可能性が ある。 

C の 関数 ►  int  CLAllociPalet  ♦♦paletHdl) ; 

返り 値は 結果を 意味す る 数値。 


$A609  CLAllocOne  I  3.Q 


引数 ► long 
long 

返り 値 DO.L 


機 能 ►  paletHdl で 指定した パレット ハンドル 中の、 palNo で 指定した パレット につ 
いて カラーの 割り付けを 斤う。 すでに 割り かけられ ていた 場合は 何もし ない。 ガ 
イ ド パレ ッ トじ I 外を 指定した 場合、 エラーが 発生す る。 

パレット の 割り 付けに 変更が 生 じる 可能性が ある。 

C の 関数 ►  int  CLAllocOne (Palet  **paletHdl , int  palNo) ; 

返り 値は 結果を 意味す る 数値。 


$A60A  CLFree  I  日. 日 


引数 ► long 
返り 値 ►  DO.L 


機 能 ►  paletHdl です 旨定 した パレット ハンドル 中の、 デバイスに 割り付けられ ている 
々ラーの 割り付けを 解除す る。 ガイ ド パレ ッ ト 以外を 指定した 場合、 エラーが 
発を する。 

この コールの あと、 割り付け 変更 イベント を 登録す る。 

パレット の 割り 付けに 変更が 生 じる 可能性が ある。 


paletHdl  ; パレ ッ ト ハンドル 


0 

パレ ッ トの 割り かけじ 変更がなかった 

1 

自分に がし、 ハ。 レッ トの削 リイ 寸 けの 変更が あった 

2 

自分の 1外 じがし、 ハ。 レッ ト の割リ がけの 変更が あった 

-1 

エラー 

paletHdl  ; ノ 、〇 レツ トノ 、ン ドル^ 

palNo  ; パレ ッ トを号 


0 

パレ ッ トの 割り付けに 変更がなかった 

1 

自分 じがし、 パレ ッ トの 割り付けの 変更が あった 

2 

自 々U 外 じがし、 ハ。 レッ トの 割り かけの 変更が あった 

-1 

エラー 

paletHdl  ; ノ 、。レツ トノ 、ン ドノ レ 


0 

パレット の 割 リイ 寸け に 変更が なかった 

1 

自分に がし、 パレ ッ トの 割り かけの 変更が あった 

2 

自分 じ 1外 にがし、 ハ。 レッ トの 割りが けの 変更が あった 

-1 

エラー 
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C の 関数 ►  int  CLFree(?alet  **paletHdl) ; 
返り 値は 結果を 意味す る 数値。 


$A60B  CLFreeOne  |_3.〇 


引 数 ► long 
long 

返り 値 ►  D0.L 


機 能 ►  paletHdl で 指定した パレット ハンドル 中の、 palNo で 指定した パレット につ 
いて々 ラ ーの 割り 付けを 解除す る。 割 り 付けられて いなか っ た 場合は 何 もしな 
い。 ガイ ド パレ ッ トじ [外を 指ました 場合、 エラーが 発生す る。 

この コールの あと、 割り付け 変更 イベントを 登録す る。 

パレット の 割り 付けに 変更が 生 じる 可能性が ある。 

C の 関数 ►  int  CLFreeOne (Palet  **paletHdl , int  palNo) ; 

返り 値は 結果を 意味す る 数値。 


$A60C  CLActive  I  3.0 


引 数 ► long 
返り 値 ►  DO.L 


機 能 ►  paletHdl で 指ました パレ ッ ト ハンドルの々 ラー を デバイス パレ ッ トに再 割り 
付けす る。 アク ティべ ー トイ ベントの 化理 中で、 自分の ウィンドウが アク ティ 
ブ になった 場合に 使用す る。 

自分の パレ ッ トに 割り付けの 変更が あった 場合は、 再 描画を 斤う 必要が ある。 
ガイ ド パレ ッ ト U 外を 指定した 場合は エラーが 発生す る。 

この コールの あと、 割り付け 変更 イ ベン トを 登録す る。 

ノ 、。レット の 割り 付けに 変更が 生 じる 可能性が ある。 

C の 関数 ►  int  CLActive (Palet  幸* paletHdl) ; 

返り 値は 結果を 意味す る 数値。 


$A60D  CLRealloc  I  3.0 


弓 I  数 ►  long  paletHdl  ; ノ 、〇 レツ トノ 、ン ドノ レ 


paletHdl  ; ノ 、〇 レツ トノ 、ン ドノ レ 


0 

ハ。 レッ トの 割り付けに 変 夏がなかった 

1 

自 かじ 対し、 パレ ッ トの 割りせ けの 変更が あった 

2 

自分に 1外 にがし、 パレ ッ トの 割り かけの 変更が あった 

-1 

エラー 

paletHdl  ; ノ 、〇 レツ トノ 、ン ドノ レ 

palNo  ;  ノ 、〇 レット 番号 


0 

ハ。 レッ トの 割り かけじ 変更がなかった 

1 

自分に タ ホし、 パレ ッ トの 割り付けの 変更が あった 

2 

自分に 1外 じがし、 ノ 、。レ ッ トの 削り 付けの 变更が あった 

-1 

エラー 

カラ— マン 
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返り 値 ►  DO.L 


2 


パレ ッ トの 割り かけじ 変更がなかった 
自分に がし、 ハ。 レッ トの 割り 化けの 変更が あった 
自分に 1外 じがし、 パレ ッ トの 割り付けの 変更が あった 
エラー 


機 能 ►  paletHdl で 指定した パレ ッ ト ハンドルの カラーを デバイス パレ ッ トに再 割り 
付けす る。 システム イベントの 化理 中で、 割り付け 変更 イベントを 受け取った 
場合に 使用す る。 

パレット の 割り 付けに 変更が 生じる 可能性が ある。 

C の 関数 ►  int  CLReaiJocCPalet  **CLRealloc) ; 

返り 値は 結果 を 意味す る 数値。 


$A60E 


C しし 1 打 kPalet 


I  3.0 


引 数 I 


long 

word 


paletHdl 

cDevID 


パレ ッ ト ハン ドル 
々ラー デバイスの 


-1(CDEV_USER) 

ユーザを 義 

0(CDEV_N0NE) 

デバイス じ リンクされ 
ていない 

l(CDEV.TEXT) 

テキス ト 画面 

2(CDEV_GRAPH) 

グラフィック 画面 

3(CDEV_M0N 日） 

モノクロ 

4(CDEV_RGB8) 

RGBS  を 

返り 値*-  DO.L 

1 

正常終了 

-1 

エラー 

機能 ►  paletHdl で 指定した パレットを cDevID で 指定した デバイスに リンクし、 ガ 
イ ド パレ ッ トに する。 

再配置が 発生す る。 

C の 関数 ►  int  CLLinkPalet (Palet  **paletHdl， int  cDevID) ; 

返り 値は 結果を 意睐 する 数値。 


$A60F 


CLUnlinkPalet 


1 3.0 


引 数 
返り 値*^ 


long 

DO.L 


DaletHdl 


; パレ ッ ト ハン ドル 


1 

正常終了 

-1 

エラー 

機 能 >  paletHdl で 指定した パレット ハンドルの リンクが 態を 解除す る 
C の 関数 ►  int  CL UnlinkPalet (Palet  **paletHdl) ; 

返り 値は 結果を 意味す る 数値。 
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$A610 


CLSetDeviceMode 


I  3 .口 


引 数 ►  word 
word 


cDevID 

mode 


; デバイス ID 
; モード 

bitO  変更 不可 


返り 値 ►  DO.L  前の モード 

= -1  エラー 

機能 ►  cDevID で 指定した デバイスの モー ドを mode にす る。 

C の 関数 ►  int  CLSetDeviceMode i±n.t  cDevID,  int  mode) ; 
返り 値は 前の モード。 


$A611 


CLGetDeviceMode 


I  3.0 


引 数 ►  word 
おり 値 ►  DO.L 


; デバイス ID 


cDevID 

モード 
= -1  エラー 

機 能 ►  cDevID で 指ました デバイスの モードを 返す。 
C の 関数 ►  int  CLGetDeviceMode ( int  cDevID) ; 

返り 値は デバイスの モー ド。 


$A612 


CLGetDevice 


rao 


引 数 I 
返り 値 ■ 


word 

DO.L 


cDevID 


; デバイス ID 


1 

正常終了 

-1 

エラー 

AO.L  デバイス パレ ツ ト ハンドル 

機 能 ►  cDevID で 指定した デバイスの デバイス パレット ハンドルを 返す。 
C の 関数 ►  Palet  *  *  CLGetDevice  ( int  cDevID) ; 

返り 値は デバイス パレ ッ ト ハンドル。 

エラーが 発生した 場合、 NULL が 返る。 


$A613 


CLAaaDevice 


1 3.0 


; ノ 、。レツ ト ハン ドル 

; デバイス ID 


を 持つ デバイス パレットと して システム じ 登録す る。 


引 

数 

long 

pa ■丄  etHdl 

word 

cDevID 

返り 値 ► 

DO.L 

登録した デバイス ID 

= -1  エラー 

機 

能- 

palet 扫 dl です 旨定 した ノ、 c レット, 

カラ— マン 
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cDevID と して- 1 を 指定す ると、 新しい デバイス のが 割り当てられる。 

C 言語から コ ー ルす る 場合は、 ライ ブ ラリの CLAddDevice を 利用す る こと。 


$A614 


C  し!) elDevice 


I  3.0 


引数 ►  word 
返り 値 ►  DO.L 


cDevID 


; デバイス ID 


1 

正常終了 

-1 

エラー 

機 能 >  cDevID で 指定した デバイス パレットを 削除す る。 

cDevID として ネ旨定 できる のは、 自分で 登録した デバイス パレ ッ トの デバイス 
ID に 限られる。 

C の 関数 ►  int  CLDelDevice ( int  cDevID) ; 

返り 値は 結果を 恵 味す る 数値。 


$A615 


CLSetDeviceRGB 


I  3.0 


引 数 I 


返り 値 I 


word 

long 

long 

long 

DO.L 


cDevID 

palNo 

number 

cListPtr 


デバイス ID 

設定を 斤う パレ ッ ト 番号 

設 をを 斤う パレット 数 

カラ ー レコ ー ド の 配列への ポインタ 


1 

正常終了 

-1 

エラー 

機能 ►  cDevID で 指定した デ バイ ス パレット 中の、 palNo から 始まる number 個の 
パレ ッ ト について、 cListPtr で 指定した々 ラーレコードの 配列の 内容を 設定 
する。 

デバイス ID が 1 (CDEV.TEXT) または 2  (CDEV.GRAPH) の 場合は、 ハー 
ドウ ュア パレット も 設定 される。 

C の 関数 ►  int  CLSetDeviceRGB ( int  cDevID,  int  palNo,  int  number , 
cRGB  *cListPtr) ; 

返り 値は 結果を 恵 味す る 数値。 


$A616 


CLDupPalet 


I  3.0 


引 数 
返り 値 ► 


機 能 


long 

DO.L 


DaletHdl 


; パレ ッ ト ハン ドル 


1 

正常終了 

-1 

エラー 

AO.L  複製され た パレ ッ ト ハン ドル 

paletHdl で 指ました パレ ッ ト ハン ドルを 複製す る。 
疑似 ハン ドル も 可。 
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冉 配置が 発生す る。 

C の 関数 ►  Palet  **CLDupPaletiPalet  **paletHdl) ; 

返り 値は パレ ッ ト ハン ドル。 

エラーが 発生した 場合、 NULL が 返る。 


$A617  CLCopyPalet  I  迁日 


引 数 

long 

long 

dPaletHdl 

sPaletHdl 

; コ ピ_ 先の パレ ッ 1 
; コ ピー 元の パレ ッ 1 

ト ハン ドル 

ト ハン ドル 

返り 値 

DO.L 

正常終了 

エラー 

AO.L 

コ ピーされ た パレ ッ 

ト ハン ドル 

機 能 ►  sPaletHdl で 指定した パレット ハンドルの カラー 情報を、 dPaletHdl で 指定 
し た ノ、。 レッ ト ハンドルに コピ ー する。 

どちら か 一方の パレ ッ ト ハン ドルに々 ラー リス トが 存在し ない 場合は エラーと 
なる。 

コ ピー 元よ リコ ピー 化の ほう が 色 数が 多い 場合は、 コ ピー 元の 色の 数 だけ コ ピー 
され、 あとは 変化し ない。 

コ ピー 元よ リコ ピー 先の ほうが 色 数が 少ない 場合は、 コ ピー 先の 色の 数 だけ コ 
ピーされ る。 

C の 関数 ►  int  CLCopyPalet (Palet  **dPaletHdl , Palet  **sPaletHdl) ; 

返り 値は 結果を 意味す る 数値。 


$A618  CLSetPickEntry  I  3.0 


引 数 ►  long  cPickProc  ; 々ラー ピックアップ ルーチンへの ポインタ 

返り 値 ►  DO.L  前の々 ラー ピックアップ ルーチンへの ポイ ンタ 

= -1 エラー 

AO.L  前の々 ラー ピックアップ ルーチンへの ポイ ンタ 

機能 ► 々ラー ピックアップ ルーチンを 登録す る。 

カラー ピックアップ ルーチン の 仕様は 下の とおり。 
int  CPickUp、cPick  *pBlock; 

引数 

typedef  struct  { 

cinfo  幸 sinfo;  /* 元の カラー レコー ドへの ポインタ*/ 

cinfo  *cList;  /* サー チす る cinfo 配列への ポイ ン タ*/ 

int  listNum;/* サー チす る cinfo 配列の 嬰 素数*/ 

/* 結果を 格納す る々 ラー レコードへの ポインタ*/ 
cinfo  *过1 凸 fo; 

}  cPick; 
cPick  *pBlock; 
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返り 値 


カラー マン 


=1 (CLS.COMPLETE)  sinf 〇 と 同じ 色を 発見した 

=  2  (CLS.INCOMPLETE)  sinfo じ 近い 色で 化 用した 
カラー ピック アッ プル ー チンは、 sinfo に 最も 近い 色を cList のなか か ら探 
して dinfo に 格納す る。 カラーマンが 色の 割り付けを 斤う 際に 呼び 化される。 
C の 関数 ►  PickUp  CLSetPickEntry (Pi ckUp  (*cPickProc) () ) ; 

返り 値は 前の カラー ピックアップ ルーチンへの ポイ ンタ。 


$A619  CLValueToRGB 


引 数 ►  word  order  ; ピクセルの 民 GB の 並び ホ 


0 

(CLO.RGB) 

R、 

G、 

B の顺 

1 

(CLO.RBG) 

民、 

B、 

G の顺 

2 

(CLO.GRB) 

G、 

民、 

B の 順 

3 

(CLCLGBR) 

G、 

B、 

民の 顺 

4 

(CLO.BRG) 

B、 

民、 

G の 順 

5 

(CLO.BGR) 

B、 

G、 

R の顺 

word 

depth 

； ピクセルの i を さ 

-1 : X680x0 形式 

long 

rgbRecPtr 

; 結果が 返る RGB レコードへの ポインタ 

long 

value 

； カラー コード 

返り 値 ►  D0.L 

=1  つねに 1 

機 能 ►  order と depth で 示された 形式の々 ラー コード value を RGB 形式に 変換 
し、 rgbRecPtr で 指定され た RGB レコー ドに 格納す る。 
depth と して- 1 を 指定した 場合、 X680x0 形式の カラー コー ドを 意味す る。 こ 
のとき、 order は 意味を 持たない。 

C の 関数 ►  int  CLValueToRGB ( int  order,  int  depth,  cRGB  *rgbRecPtr, 
int  value) ; 

結果は cRGB 型の 変数 rgbRecPtr に 返る。 

返り 値は つねにし 


$A61A  CLRGBToValue  し 辽日 


弓 1  数 ►  word  order 


word  depth 


ピクセルの RGB の 並び 方 


0 

(CLO_RGB) 

民、 

G、 

B の顺 

1 

(CLO-RBG) 

民、 

B、 

G の顺 

2 

(CL0_GRB) 

G、 

民、 

B の 順 

3 

(CLO.GBR) 

G、 

B、 

民 の 順 

4 

(CLO-B 氏 G) 

B、 

民、 

G の 順 

已 

(CLCLBGR) 

B、 

G、 

民 の顺 

ピクセルの‘; おさ 
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-1 : X680x0 形式 

long  rgbRecPtr  ;  RGB レコー ドへの ポインタ 

返り 値 ►  D0.L  カラー コード 

機 能 ►  rgbRecPtr で 指定した RGB レコー ドの 内容を、 order と depth で 示される 
形式の カラー コードに 変換す る。 

dep け！ として- 1 を 指定した 場合、 X680x0 形式の カラー コードを 返す。 このと 
き order は 患 味を 持たない。 

C の 関数 ►  int  CLRGB To Val u e ( int  order, int  depth , cRGB  *rgbRecPtr) ; 
返り 値は々 ラー コード。 


$A61B  CLRefer2 


Cajo 


引 数- 

word 

返り 値 

D0.L 

A0.L 

pltllD 


1 

正诛; 終了 

-1 

エラー 

; ハ 〇レッ ト テン プ レー トリ ソース （‘PLTL，） の 

ID 


ノ 寺 レツ ト ハン ドル 

機 能 ►  pltllD で 指定した パレット テンプレートを 参照し、 パレット ハンドルを 作成 
する。 


パレ ッ ト テンプレートは パレット リ ソース （または デ ハ* イス パレ ッ ト） と、 その 
なかの 必要な 色を 指定す るリ ソースで、 SYSTEM. LB に 用意され ている パレ ッ 
ト テン プ レートリ ソースは U 下のと おり。 


-128 

(PALT_G16) 

グラフィック 16 を 

-129 

(PALT_G256) 

グラフィック 256 を 

-130 

(PALT_G65536) 

グラフィック 65536 色 

-11 

(PALT_PAT1) 

PAT1 表示 用 

-12 

(PALT_PAT2) 

PAT2 表示 用 

-13 

(PALT_PAT3) 

PAT3 表示 用 

-14 

(PALT_PAT4) 

PAT4 表示 用 

-22 

朱 使用 

-23 

朱 化 用 

-24 

未使用 

-33 

未使用 

-34 

ホ 使用 

-44 

未使用 

3 

(PALT.MONO) 

モノクロ 

4 

(PALT_RGB8) 

RGBS  色 

じ [下の 2 つの ID は、 リソース としては 用意され て おらず、 指定した 場合は シス 


テム 内部 で 特殊 な 処理が 斤 われる。 


1 

(PLT し T  巨  XT) 

テ ネスト 自動 判別 

2 

(PLT し GRAPH) 

グラフィック 自動 判別 

再配置が 発生す る。 

C  の 関数 ►  Palet  *  *  CLRefer2  (int  pltllD) ; 
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返り 値は パレ ッ ト ハン ドル。 

エラー が 発生し た 場合、 NULL が 返る。 
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$A61C  CLLoadText 


Ha •己 


引 数 ► 
返り 値 


機能- 


な  し 

D0.L 


1 

正常終了 

-1 

エラー 

テキストの デバイス パレ ッ トを 初期化す る。 


C の 関数 ►  int  CLLoadText  (void) ; 

返り 値は 結果を 恵 味す る 数値。 


$A61D  CLValueToPalet 


Cao 


引 数 ► long 
long 

返り 値 ►  D0.L 
A0.L 


vListPtr 

vNumber 


1 

正常終了 

-1 

エラー 

ノ、 ° レツ ト ハン ドル 


; カラー コードの 配列への ポインタ 
; カラー コードの 配列の 嬰 素数 


機 能 ►  vNumber 個の 叟 素を 持つ vListPtr で 指定した カラー コードの 配列から、 パ 


レッ ト ハンドル （々ラ ー リス ト 付き） を 作成 する。 

々ラー コードの 配列は、 カラー コード (word) を 並べた もの。 
再配置が 発生す る。 


C  の 関数 ►  Palet  *  *  CLValueToPalet  ( VLi  st  *vListPtr,  int  vNumber) ; 


返り 値は パレ ッ ト ハン ドル。 

エラーが 発生した 場合、 NULL が 返る。 


$A61E  CLPaletToValue 


引数 >  long 
long 

返り 値 ►  DO.L 
AO.L 


paletHdl  ; ノ 、〇 レツ トノ 、ン ドノ レ 

vListPtr  ; 結果が 返る々 ラーコー ドの 配列への ポインタ 


1 

正常 終 Y 

—1 

エラー 

結果が 格納され た々 ラー コードの 配列への ポインタ 


機 能 ►  paletHdl で 指定した パレ ッ ト ハン ドルの カラー リス ト から 登録され ている 力 
ラーの々 ラー コー ドを 計算し、 vListPtr で 指定され た 配列に 格納す る。 
vListPtr として 0 を 指定す ると、 ヒープ 上に 配列を 確保す る。 

再 配 蘆が 発生す る。 


C  の 関数 ►  VList  *CLPa]et  To  Value  (Palet  **paletHdl,  VList  *vListPtr) ; 
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返り 値は々 ラー レコードの 配列への ポイ ンタ。 
エラーが 発生した 場合、 NULL が 返る。 


$A61F 


CLSetScanEntrv 


I  3.0 


引 

数 

long 

paletHdl 

; ノ 、。レツ ト ハン ドル 

long 

rgbScanProc 

; カラー スキャン ルーチンへの ポインタ 

返り 値 ► 

DO.L 

前の カラー スネ ャ ン ルーチンへの ポイ ンタ 

= -1  エラー 

AO.L 

前の々 ラ ー スキャン ル ー チンへの ポイ ンタ 

機 

能- 

paletHdl で 指定した パレット 
キャン ルーチンを 登録す る。 

ハン ドルに rgbScanProc でキ 旨を した々 ラー ス 

カラー 

スキャン ルー チ ンの 仕様は] a 下の とおり。 

int  ScauRGBCcRGB  *dRGB 

cRGB  *sRGB,  Palet  **paletHdl) 

引数 

cRGB 

♦ciRGB 

実際の 色を 恪納 する RGB レコー ドへの ポイ 

ンタ 

cRGB 

幸  sRGB 

ボ める 色を 格納す る RGB レコードへの ポイ 

ンタ 

Palet 

本本 paletHdl 

色を 探す 環境と なる パレ ッ ト ハンドル 

返り 値 

sRGB を 意味す る々 ラー コード 

カラー スキャン ルー チンは、 sRGB に 最も 近い 色を paletHdl で 指定した パレ ッ 
ト ハンドルの々 ラー リストの なかから 探して dRGB に 格納す る。 また、 それを 
々ラー コードに 変換した ものを 返り 値と する。 イメージの コ ピーを 行う 際に 呼 
び 出される。 

C の 関数 ►  RGBScan  CLSetScanEntry (?a.let  **paletHdl, 

RGBScan  (れ gbScanProc) ()) ; 

返り 値は 前の カラー スキャン ルーチンへの ポイ ンタ。 

エラ ーが 発生し た 場合、 NULL が 返る。 


ライブラリ 


CLActive2 


引 数 ►  Palet  **paletHdl  ; パレ ッ ト ハンドル 

返り 値 ►  0  ハ。 レッ トの 割りが •けに 変更がなかった 

0 U 外  パレット の 割り 付けの 変更が あった 

機 能 ►  $A60C  CLActive を コールし、 自分 外の パレットに 割り付けの 変更が 発生 

した 場合は 割り付け 変更 イベント を 登録す る。 
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C の 関数 ►  int  CLActive2 (Palet  **paletHdl) ; 


ライブラリ  C し Ad 过 Device 


引 数 ►  Palet  **paletHdl  ; パレット ハンドル 

int  (幸 DevSet)  0  dSet  ; カラー コード セッ トルー チン 
int  cDevID  ; デバイス ID 

おり 値 ►  DO.L  登録した デバイス ID 

= -1  エラー 

機 能 ►  paletHdl で 指定した パレット ハンドルを、 cDevID で 指定した デバイス の 
を 持つ デ バイ ス パレットと して システム じ 登録す る。 
cDevID として- 1 を 指定す ると、 新しい デバイス ID が 割り当てられる。 
dSet じは、 デ バイ スノ、 ° レッ トじ カラ ー コ ー ドを セッ ト する ル ー チンの エン ト 
リを 指定す る。 割り付け じ 際して々 ラー コードを 設定す る 必要が ある 場合に、 こ 
の ルーチンが 呼ばれる。 NULL を 指を すると、 害 I) り 付け 時に 何も 呼び出さない。 
DevSet 関数の 仕様は り* 下の とおり。 

typedef  int  (幸 DevSet バ）； 

int  DevSet (CInfo  *ciPtr,  int  clNum) ; 

CInfo  ciPtr  value および RGB 値が 格納され ている 

cInfo 構造体への ポイ ンタ 

int  clNum  デバイスの々 ラー リスト 番号 

SX コールと ライブ ラ リ では 引数の 数が 違う。 アセンブラから 利用す る 場合は、 
デ ノ スイ ス セット ル ー チ ンの エントリを pHdl の dSet じ セットす る こと。 また、 
SXCALL 宣言に よって 実装され ている callno ヘッダの $A613  CLAddDevice 
関数は 引き数が 2 つで、 アセンブラからの 場合と 同様に 呼び出す 必要が ある。 

C の 関数 ►  int  CLAddDevice  (Palet  **paletHdl,  DevSet  (*dSet) () , 
int  cDevID) ; 


ライブラリ  CLDisposePalet2 


引 数 ►  Palet  **paletHdl  - ; パレット ハンドル 
返り 値 ►  $A605  CLDisposePalet の リザ ル トコー ド。 

CLDisposePalet 力ぶ 失敗した 場合は、 そめ あとに 実行した $A35A  TSPostEve 
irtTsk のり ザル トコー ド。 

機能 ►  CLDisposePalet を コールし、 自分 外の パレットに 割り付けの 変更が 発生 
した 場合は 割り付け 変更 イ ベン トを 登録す る。 

C の 関数 ►  int  CLDisposePalet2 ( Palet  **paletHdl) ; 
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ライブラリ  CL 巨 vent 


引 数 ►  Window  *winPtr  ; ウィンドウ レコードへの ポインタ 

Palet  本本 paletHdl  ; ノ、 〇レツ トノ 、ン ドノ レ 

TsEvent 幸 eventRecPtr  ; タスク マン イベント レコー ドへの ポインタ 
返り 値 ►  =  0  ノ 、。レットの 割り付けに 変更がなかった 

牛。  パレット の 割り 付けに 変更が あった 

機 能 ►  winPtr で 指定した ウィ ン ドウに 用いられ ている paletHdl で 指を した パレ ッ 
ト ハン ドルに ついて、 eventRecPtr で 指定され たイ ベント レコ ー ドの 内容に 
が応 する。 

が応 する のは、 じ I 下の 2 つの イベント。 

• アク ティべー トイ ベント 

•  Syste 皿 1 イベント （タスク マン イベント コード 92  : 割り付け 変更 イべ 
ント） 

それぞれ、 必要に応じて $A60C  CLActive.  $A60D  CLRealloc を 呼び出し、 
自分 外の パレット じ 割り 化けの 変更が 発生した 場合は 割り 付け 変更 イベント 
を 登録す る。 

内部で $A35A  TSPostEventTsk を コールし ている ため、 タスクの 切り替えが 
発生す る。 

C の 関数 ►  int  CLE vent  (Window  *winPtr,  Palet  **paletHdl,  TsEvent 
本 eventRec) ; 
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ビデオ スン 


$A700 


VMInit 


I  3.Q 


引 数 ► long 
返り 値 ►  D0.L 


A0.L 


resNameListPtr  ; リソース ファイル 名の リストへの ポインタ 


0 

正常が 了 

-1 

エラー 

other 

すでに ネ刀 期イヒ 巧み. バージョン 番号 

0 

正常終了 

-1 

エラー 

other 

リ ソー スマップへの ハン ドルの リス ト への ポイ ンタ 

機 能 ►  ビデオ マンを そ 刀 期 化する。 resNameListPtr で 指定した 6 個までの リソー 
スフ アイ ルを ビデオ マンの 口一々 ルリ ソースと して オープン する。 

ビデオ マンは IVM.X が 起動した 時点で 初期化’ 済みな ので、 一般の アプリ ケー 
ショ ンを 呼び出す 必要は ない。 

C の 関数 ► long  VMInit ( char  *resNameListPtr  [] ) ; 

返り 値は、 バー ジョン 番号、 または リソース マップへの ハンドルの リストへの 
ポインタ、 または リザルト コード。 


$A701 


VMTini 


I 日. 日 


引 数- 
返り 値 ► 


なし 

D0.L 


0 

正常終了 

-1 

エラー 

機 能 ►  ビデオ マンの 終了 化理を 斤う。 口一々 ルリ ソース は 廃棄され る。 

一般の アプリ ケー シヨ ンを 呼び出す 必要は ない。 

C  の 関数 ► Ion  良  VMTini  (void) ; 

返り 値は リ ザル トコ ー ド。 


$A710 


VMExpand 


3.0 


引 数 • 


long 

bitsHdl 

; 展關 先の ビッ ッ への ハンドル 

long 

buffHdl 

; 压縮 デー タ への ハンドル 

long 

rscID 

; VM モジュールの リソース ID 

long 

sRectPtr 

; 展關 する 元の 画像の 範囲を 意味す る レ クタ 
ン グル レコ ー ドへの ポイ ンタ 
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long 

dRectPtr 

； 展關 後の 画像の 範囲を 意味す るレク タング 

ルレ コー ドへの ポイ ンタ 

long 

user 

; VM モジ ュ ー ルへ 渡す データ 

返り 値 ►  D0.L 

リザルト コ ー ド 

A0.L 

ビッ ツ への ハン ドル 

機能 ►  buffHdl で 指定した 圧縮 画像を rscID で 指ました VM モジュールを 用いて 
bitsHdl で 指定した ビッツ に 展開す る。 その 際、 元 画像の sRectPtr で 指定 
した 領域を dRectPtr で 指定した サイズで 拡大/縮小 する。 また、 必要が ある 
場合は user で VM モジ ュー ルに データを 渡す ことができる。 
bitsHdl に 0 を 指定した 場合、 ビデオ マンが ビッツ を 作成す る。 
rscID に- 1 を 指定した 場合、 画像の フォーマットを 自動的に 判断して 適当 
な モジュールを 使用す る。 

sRectPtr,  dRectPtr は 0 を 指定す る こと で 省略 可能。 

再配置が 発生す る。 

C の 関数 ►  Bits  **VMExpand (Bits  **bitsHdl , Handle  buffHdl, 

long  rscID,  Rect  *sRectPtr,  Rect  幸 dRectPtr,  long  user) ; 

返り 値は ビッ ツ への ハン ドル。 

エラーが 発生した 場合、 NULL が 返る。 


$A711  VMCompress  I  3 •口 


引 

数 

long 

bitsHdl 

; 元の 画像の ビッ ツ への ハンドル 

long 

buffHdl 

; 圧縮 データが 格納され る ブロックへの ハン 

ドル 

long 

rscID 

;VM モジュールの リソース ID 

long 

sRectPtr 

; 圧縮す る 元の 画像の 範囲を 意味す る レ クタ 
ン グル レコ ー ド への ポインタ 

long 

dRectPtr 

; 圧縮 後の 画像の 範囲を 意味す るレク タング 
ルレ コー ドへの ポイ ンタ 

long 

user 

; VM モジュールへ 渡す デー タ 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

圧縮 データが 格納され た ブロックへの ハンドル 

機 

能- 

bitsHdl で 指定 した ビッ ツの 画像を rscID で 指定した VM モジュールを 用いて 

圧縮し buffHdl で 指定した ブロック じ 格納す る。 その 際、 元 画像の sRectPtr 
で 指定した 領域を dRectPtr で 指定した サイ ズで 拡大/縮小 する。 

また、 必要な 場合 じは、 user で VM モジ ュー ルに デー タを 渡す ことができる。 
buffHdl で 指定した ブロ ックが 十分な 大きさを 持たない 場合は、 拡張され る。 
また、 0 を 指定した 場合、 ビデオ マンが ヒープ 上に 作成す る。 
rscID に- 1 を 指定した 場合、 $A716  VMSetCurrentID で 指定され たモ 
ジュールを 使用す る。 

sRectPtr,  dRectPtr は 0 を 指定す る ことで 省略 可能。 
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再配置が 発生す る。 

C の 関数 ►  Handle  VMCompress (Bits  **bitsHdl,  Handle  buf fHdl , 

long  rscID,  Rect  *sRecxPtr ,  Rect  幸 dRectPtr,  long  user); 
返り 値は、 圧縮 データが 格納され た ブロックへの ハン ドル。 

エラー が 発生した 場合、 NULL が 返る。 


$A712  VMExpDirect  I  3.0 


引 

数- 

long 

bitsHdl 

; 展開 先の ビッ ツ への ハン ドル 

Ion 良 

buffHdl 

; 圧縮 デー タへの ハン ドル 

long 

rscID 

; VM モジ ユー ルの リ ソース ID 

long 

user 

; VM モジ ュー ルへ 渡す デー タ 

返り 値 

DO.L 

リ ザル トコー ド 

AO.L 

ビッ ツ への ハン ドル 

機 

能- 

buffHdl 

で 指定した 圧縮 画像を rscID で 指定した VM モジ ュー ルを 用いて 

bitsHdl で 指定した ビッツ じ窩速 展開す る。 必要な 場合には、 user で VM 
モジュールに データを 渡す ことができる。 

エラー チ 卫ック 等を 省いて いるた め、 高速に 展開で きる 反面、 じ [下の 3 点を 守 
ら ない 場合には 動作が 保証され ない。 

•  bitsHdl として ロック された ビッツ への ハンドルを 指定し なければ なら 
ない。 

•  rscID として 圧縮 画像の フォーマットに 適した モジ ュー ルの の を 指定し 
なければ ならない。 

• 元の 画像と 展關 先の ビッツ の サイ ズは 同じで なければ ならない。 


再配置が 発生す る。 

C  の 関数 ►  void  VMExpDirect  (Bits  **bitsHdl,  Handle  buf  fHdl, 
long  rscID,  long  user); 

返り 値は ない。 


$A713 

VMGetInfo 

1  3.0 

引 数 ► long 

rscID 

; VM モジュールの リ ソース ID 

long 

buffHdl 

; 圧縮 データへの ハン ドル 

long 

namePtr 

; フ アイ ルネー ム への ポインタ （ASCIIZ 型） 

long 

tblPtr 

； 結果が 返る バッファ （256 バイト） への ポイ 

ンタ 

long 

user 

; VM モジ ュー ルへ 渡す デー タ 

返り 値 ►  DO.L 

VM モジ ュ 

— ルの リ ソース ID/ リ ザル トコード 
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-1 サポートで きない 圧縮 フォーマット 
-2  ]_ 展關 途中で エラー が 発生した 

AO.L  結果 力 《返る バッファへの ポインタ 


(A0) .L 

rscID 

VM モジュールの リ ソース ID 

4(A0) 

idName 

モジュール 名 （32 バイト） 

36(A0) 

idData 

モジ ュー ルに 渡された デー タ （128 バイ 
卜） 

164(A0) 

extFName 

サポートす る 拡張 子 （4 バイト） 

168(A0).W 

forPhoto 

VMGetInfo で モジ ュー ルの リ ソース ID 
と して- 1 を 指定した 際に 検索の が 象と な 
るなら 1 

170(A0) .W 

forMovie 

$A739  VMRegistSample  可能なら ば 1 

172 (AO) .W 

withHeader 

識別 ヘッダが ついていて、 $A710 
VMExpand でリ ソース のと して- 1 を 
指定した ときに 検索の 対象と なるなら 1 

174(A0) .W 

fixe 地 ounds 

サ ポート する 圧縮 画像の レク タング ルが 
固定 サイズな らば 1 

(の Ji は、 必ず 格納され る データ。 下は、 モジュールに よっては 
格納され ない 場合が ある） 


176(A0) .W 

bitsTy7e 

最適な スク リーン タイプ 

178(A0) .W 

useBits 

を 表現に 必要な ビット 数。 フル々 ラーの 
場合は- 1 

180(A0) .W 

withPalette 

パレット を 持つ かどう かの フラグ 

182(A0) 

baseRect 

想定され ている ベー ス 画面の レ ク タング 

ノレ 

実際に 晒 像 展開され る レ クタ ン グル 

190 (AO) 

picRect 

198(A0) .L 

expTime 

展開に 必要な が閒 （1/100 ネ少 単位） 

十分に 早い 場合は 0、 不明な 場合は一 1 

202 (AO) 

reserved 

システム 予約 G8 バイト） 

240(A0) 

user 

モジュール じ 固有な 領域 （16 バイト） 

機 能 ►  buffHdl で 指定した 店 縮 画像を rscID で 指定した VM モジ ュー ルで 解ネ 斤した 
結果を、 tblPtr の バッファに 返す。 

rscID として- 1 を 指定す ると、 圧縮 画像の フォー マットと namePtr で 指定 
した ファイル ネーム を もとに 適当な モジ ュー ルを 呼び出す。 rscID じ 値を 指定 
する 場合、 namePtr は NULL でもよ い。 

buffHdl,  namePtr の 両方に NULL を 指定した 場合、 rscID で 指定した VM 
モジュール に関する 情報 （DO.L) だけが 返される。 

必要な 場合 じは、 user で VM モジュールに デー タを 渡す ことができる。 
再配置が 発生す る。 

C の 関数 ► long  VMGetInfo ( long  rscID, Handle  buf fHdl , char  *namePtr, 
VideoIPtr  tblPtr,  long  user) ; 

返り 値は、 VM モジュールの リソース ID、 または 結果を 意味す る 数値。 
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$A714  VMRscInfo 


113.0 


引 

数 

long 

rscType 

; リ ソース タイプ 

long 

rscID 

; リソース ID 

long 

listHdl 

; 結果が 返る ブロ ック への ハンドル 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

結果が 格納され た ブロ 

ッ ク への ハン ドル 

機 

能- 

この コ 

ー ルを 呼び出した タスクが アクセス 可能な リ ソース と ビデオ マンの リソ 

ス 中から rscType で 指定した リ ソース を 探し、 結果を listHdl で 指定され 
た ブロ ックに 格納す る。 
rscID は 意味を 持たない。 

listHdl で 指定した ブロックの サイズが 足りない 場合、 ビデオ マンが 拡張す 
る。 また、 listHdl として 0 を 指定す ると、 ビデオ マンが ヒープ 上に 作成す 
る。 

rscType と して一 1 を 指を すると、 （VMIF， ， fVMEC， の 一覧を 返す。 

結果は の 《 下のと おり。 

list : 


ds.l 

1 

♦ デー タの 個数 

1 個 目の データ 

ds.l 

1 

* リ ソー スタ イプ 

ds.l 

1 

* リ ソース ID 

2 個 目の データ 

再配置が 発生す る。 

C の 関数 ► long  VMRscInfo ( 1 ong  rscType , long  rscID, Handle  listHdl) ; 
返り 値は リザルト コード。 


$A715  VMRscHdlGet 


C3.0 


引 

数- 

long 

rscType 

; リ ソー スタ イプ 

long 

rscID 

; リ ソース ID 

返り 値- 

DO.L 

リ ザル トコード 

AO.L 

指定され たリ ソー 

•ス への ハン ドル 

機 

能- 

この コ 

— ルを 呼び 江  1, した タスクが アクセス 可能な リソ 

ス 中から rscType と rscID で 指定した リ ソースを 読み込み、 その ハン ドルを 
返す。 

再配置が 発生す る。 

C の 関数 ►  Handle  VMRscHdl  Get  (long  rscType , long  rscID) ; 

返リ 値は 指定され たリ ソースへの ハン ドル。 
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$A716  VMSetCurrentID  I  3.0 


引 数 ► long  rscID  ;  VM モジ ュー ルの リ ソース ID 

返り 値 ►  DO.L  前の VM モジュールの リ ソース ID 

機 能 ►  画像 圧縮 時に デフ オル トで 用いられる VM モジュールの リ ソース ID を セット 
する。 

再配置が 発生す る。 

C  の 関数 ► long  VMSetCurrentID  (long  rscID) ; 

返り 値は 前の VM モジ ュー ルの リ ソース ID。 


$A717  VMGet Current ID 


Cao 


引数 ► なし 

返り 値 ►  DO.L  デフォルトの VM モジュール のり ソース ID 
機 能 ►  画像 圧縮が に デフォルトで 用いられる VM モジュールの リ ソースの を 返す。 
C の 関数 ► long  VMGetCurrentID (void) ; 

返り 値は、 デフ オル トの VM モジュールの リ ソース の。 


$A718  VMGetPalette 


; VM モジ ュー ルの リソース ID 
; 圧縮 デー タへの ハンドル 
; VM モジ ュー ルへ 渡す デー タ 


た VM モジュールで 解析し、 カラー パレ ッ ト ハンドルを 返す。 
rscID として- 1 を 指を すると、 適当な モジュールを 呼び出す。 

必要な 場合 じは、 user で VM モジ ュー ルに デー タを 渡す ことができる。 再 配 
置が 発を する。 


引 

数 

long 

rscID 

long 

buffHdl 

long 

user 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

AO.L 

ハ 〇レツ ト ハン ドル 

機 

能 

buffHdl で 指定した ブロ ッ ，ノ 

C の 関数 >-Pale1:  **VMGetPaiette(long  rscID,  Handle  buffHdl, 
long  user) ; 

返り 値は パレ ツ ト ハン ドル。 

エラーが 発生した 場合、 NULL が 返る。 
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$A730 


VMSetAnim 


3.0 


引 数 ► long 
返り 値 ►  DO.L 
AO.L 


; アニメ ー  シヨ ンポ ー ト への ハンドル 


animHdl 

リ ザル トコ ー ド 

前の アニメ  ー シヨ ンポ ー ト への ハン ドル 
=  0  存在 しない 

機 能 ►  animHdl で 指定した アニメーション ポートを々 レントに する。 
C の 関数 ►  Handle  VMSetAnim  (Handle  animHdl) ; 

返り 値は、 前の アニメー ション ポートへの ハンドル。 

エラーが 発生した 場合、 TOLL が 返る。 


$A731 


VMGetAni 皿 


3.0 


引数 ►  なし 

返り 値 ►  D0.L  リ ザル トコ ー ド 

= -1 存在し ない 

A0 .  L  アニメ ー  シヨ ンポ ー ト への ハンドル 

=0  存在し ない 

機 能 ►  カレント アニメーション ポートを 返す。 

C の 関数 ►  Handle  VMGetAnim (void) ; 

返り 値は アニメ ー ショ ン ポー ト への ハン ドル。 
エラー が 発生し た 場合、 NULL が 返る。 


$A732 


VMSetParam 


3.0 


引 数 ► long  paxmlD 


long  value 1 


パラメータ ID 


0(PARAM_DURATI0N) 

KPARAM.TIMESCALE) 

2(PARAM_RATE) 

3(PARAM_CURTIME) 

4(PARAM_SELTIME) 

5(PARAM_SELDUR) 

6(PARAM_PREFRATE) 

7(PARAM_PLAYRECT) 

8(PARAM_USERAT0M) 


総 再生 時閒 

タイ ムス ケール 
スピ ー ドレ ー ト 

現在 時刻 

部分 再生 開始が 刻 
部分 再生が 間 長 

デフ ォル ト レート 
再生 レク タン グル 
ユーザ データ 


設定 値 


返り 値 ►  D0.L 


A0.L 


0 

正常終了 

-1 

エラー 

前の 設定 値 


機 能 ►  par 皿 ID で 指定した 内を について、 各種 値の 設定を 斤う。 
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詳細は、 各 設定 じついての マクロを 参照の こと。 

C の 関数 ► long  VMSetParam (long  parmID,  long  value) ; 
返り 値は 前の 設定 値。 


$A733 


VMGetParam 


r  3.0 


引 数 ► long  paxmlD 


パラメータ ID 


0(ARAM_DURATI0N) 

総 再生 時 
閒 

KARAM.TIMESCALE) 

タイ ムス 
ケール 

2(ARAM_RATE) 

ス ピー ド 
レー ト 

3(ARAM_CURTIME) 

現在 時刻 

4(ARAM_SELTIME) 

部分 巧 化 
開始 時刻 

5(ARAM_SELDUR) 

部分 再生 
時間 長 

6(ARAM_PREFRATE) 

デフ オル 
ト レート 

7(ARAM_PLAYRECT) 

再生 レク 
タ ン グル 

8(ARAM_U 沈 RATOM) 

ユーザ デ 

—夕 

$1000(PARAM_WIDTHHEIGHT) 

アニメー 

シヨ ン画 

像の 縦横 
幅 

$1001(PARAM_STATUS) 

アニメー 

シヨ ンポ 
ート のが 
態 

$1002(PARAM_MEDIAM0DE) 

圃像メ デ 
ィ アの種 
類 

$1003 (PARAM.FRAMDUR) 

指* 定フレ 
—ムの 巧 
生 時間 

$1004 (PARAM-TOTALS AMPLE) 

総 サン プ 
ル 数 

$100 已 (PARAM-CURSAMPLE) 

カレント 
の サン プ 
ル ID 

$1006 (PARAM_TOTALFRAME) 

総フ レー 
ム 数 

返り 値 ►  DO . L 


0 

正常終了 

-1 

エラー 
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AO.L  前の 設定 値 

機 能 ►  parmlD で 指定した 内容に ついて、 設定され ている 値を 返す。 

詳細は、 各 設定に ついての マクロを 参照の こと。 

C の 関数 ► long  VMGetParam ( long  parmID) ; 

返り 値は 前の 設定 値。 


$A734 

VMCreate 

1  3.0 

引 数- 

なし 

返り 値*^ 

D0.L  リザルト コード 

A0 .  L  アニメ ー  シヨ ンポ ー ト への ハンドル 

機 能 > 

アニメ ー シヨ ン ポー トを ヒープ 上に メモリ モー ドで 作成す る。 作成した アニメー 

シヨ ン ポート は オープン 状態で々 レント になる。 

巧 配置が 発生す る。 

C の 関数 > 

Handle  VMCreate  (void) ; 

返り 値は アニメ ー シヨ ン ポート への ハン ドル。 

エラー が 発生し た 場合、 NULL が 返る。 

$A735 

VMCreateF 

1  3.0 

long  f ilelD  ; ファイル ハンドル 

D0.L  リザ ル トコード 

A0 .  L  アニメ ー  シヨ ンポ ー ト への ハンドル 

ァニメ ー シヨ ン ポー トを ヒープ 上に ファイル モー ドで 作成す る。 作成した ァニ 
メー シヨ ンポ ートは オープン 状態で、 カレントになる。 

内容を 変更す る 場合は、 ファイルを read/write モー ドで 才ー プン して おく 必要 
が ある。 

すでに 存 がする フ ァイ ルの フ ァイ ルハン ドルを 渡した 場合は、 それが ァニメ ー 
シヨ ン ファイル であるか どうかを チェックし、 そうでない場合は エラーを 返す。 
アニメ ー シヨ ン ファイルの 場合は 変更 モー ドと なり、 モー シヨ ン 部を メモリに 
読みを む。 

サイズが 0 の ファイルの ファイル ハンドルを 渡し た 場合は、 ヘッダを 書き 込む。 
巧 配 蘆が 発生す る。 

C の 関数 ►  Handle  VMCreateF ( 1 ong  f  ilelD) ; 

返り 値は アニメ ー シヨ ン ポートへの ハン ドル。 

エラー が 発生し た 場合、 NULL が 返る。 


引 数- 
返り 値 

機能- 
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$A736  VM  日  pen  rao 


引 数 ►  long  animHdl  ; アニメー シ ヨン ポート への ハンドル 

返り 値 ►  D0.L  リザルト コード 

機能 >  animHdl で 指定 した クローズが 態の アニメーション ポートを 才ー プンが 態に し 
て、 々レント にす る。 

再配置が 発生す る。 

C の 関数 ► long  VMOpen (Handle  animHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A737  VMClose  r^：Q 


引 数 ►  long  animHdl  ; アニメー シヨン ポート への ハンドル 

返り 値 ►  D0.L  リ ザル トコ ー ド 

機 能 ►  animHdl で 指ました オープンが 態の アニメー ショ ンポー トを クローズが 態に す 
る。 

メモリ モー ドで 才ー プン している 場合は、 ヒープ* 上の データは 廃棄され ない。 
ファイル モー ドで オープン している 場合は、 アニメーショ ン ファイルは クロー 
ズ されない。 モーション 部、 メディア 部に 変更が あった 場合は、 それぞれを ファ 
イ ルに 書き 化す。 

再配置が 発生す る。 

C の 関数 ► long  VMCiose (Handle  animHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A738  VMDispose  「 3。 


引 数 ► long  animHdl  ; アニメーション ポート への ハンドル 

返り 値 ►  D0.L  リザルト コード 

機能 >  アニメーション ポートを 廃棄す る。 再生 中の 場合、 再生は 停止され る。 々レン 
ト アニメーション ポート を 廃棄した 場合は、 々レント アニメーション ポート カぶ 
存を しないが 態になる。 

メモリ モー ドで 才ー プン している 場合は、 ヒープ 上の データは 廃棄され る。 

ファ イノ  モー ドで 才ー プン している 場合は、 ファイルは クローズ されない （ファ 
イ ルの クローズは アプリ ケー ショ ン侧で 斤う 必要が ある）。 モー ショ ン 部に 変更 
があっ た 場合で も ファ イ ルへの 書き 化し は 巧 わ ない。 

巧 配置が 発生す る。 

C の 関数 ► long  VMDispose ( Heindle  animHdl); 

返り 値は リ ザル トコー ド。 
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$A739 

VMRegistSample 

1  3.0 

引 数 

long 

buffHdl 

; (圧縮） 画像 データへの ハンドル 

long 

Duff Size 

; (圧縮） 画像 データの バイト 数 

long 

rscID 

; VM モジュールの リ ソース ID 

long 

sizePt 

; 画像の 大きさ を 意味す る ポイント 

返り 値 ► 

DO.L 

サンプル ID/ リザルト 

、コー ド 

機 能 > 

々レン ト アニメ ー  シヨ ンポ ー ト 

(オープンが 態） じ buffHdl で 指定した 画像 

データを 1 枚 登録す る。 登録に 成功した 場合、 登録 画像の 通し番号 （サン プ 
ル ID) が 返る。 サンプルのは $A738  VMDispose する まで 有効で、 のちに 
$A735  VMCreateF 等で オープンした 場合は、 画像と サンプル ID の 対応 関係 
は 変化して いる 場合が ある。 

rscID と して- 1 を 指定す ると、 画像 デー タの フォー マッ ト から 判断して 適当 
な VM モジュールを 呼び出す。 
buffHdl は 疑似 ハン ドル も 可。 

再配置が 発生す る。 

C  の 関数 ► long  VMRegistSample  (Handle  buffHdl,  long  buff  Size, 
long  rscID,  LPoint  sizePt) ; 

返り 値は、 サンプル ID または リザルト コード。 


$A73A  VMDeleteSample  I  3 •日 


引 数 ► long  samplelD  ; 削除す る 画像の サンプル ID 

返り 値 ►  D0.L  リザ ル トコー ド 

機 能 ►  才 ープン 状態の メモリ モー ドの カレン ト アニメー シヨ ン ポート から samplelD 

で 指を する 画像を 削除す る。 

再配置が 発生す る。 

C の 関数 ► long  VMDeleteSam pled ong  samplelD) ; 

返り 値は リ ザル トコ ー ド。 


$A73B 

VMRef erSample 

1 3.0 

引 数- 

long 

samplelD  ; 

i サンプル ID 

long 

buffPtr  ; 

; 結果が 返る バッファ （28 バイト） への ポイ 

ンタ 

返り 値- 

DO.L 

リ ザル トコー ド 

AO.L 

ハ* ッ ファへの ポイ ンタ 

ビ テオ マン 


527 


ビデオ マン 


(AO).L 

mediaMode 

0  メモリ モード 

1 ファイル モー ド. 編集 中 

2 ファイル モー ド. 参照 中 

4(A0) .L 

fd 

ファ イ ル ハ ン ドル （メモリ モ ー ド の 場合 
は- 1) 

8 (AO) .L 

of stHdl 

關像 格納 バッファへの ハン ドル 

12 (AO) .L 

size 

顾像 データの バイト 数 

16 (AO) 

picRect 

晒 傑 デ ー タ のレク タン グル 

24 (AO) .L 

rscID 

刚像 デー タを 扱う VM モジ ュー ルの リソー 
ス ID 

機 能 ►  カレン ト アニメ ーショ ン ポートに 登録され ている samplelD で 指定され る 画像 
に I 划 する 情報を buffPtr で 指定 される バッファに 返す。 

これに よって 得られた 画 傑 デ ー タ への ハンドルを 利用して、 画像の 内容 
を 変更して はならない。 再配置が 発生す る。 

C の 関数 ► Ion だ  VMReferSampledong  samplelD ,  VideoSamplelPtr  buf fPtr) ; 
返り 値は リ ザル トコ ー ド。 


$A73C 

VMGetSample 

1  3.0 

引 数 

long  samplelD  ; サンプル  ID 

返り 値 ► 

DO.L  画像 データの バイ ト 数/リザルト コード 

A0.L  圃像 デー タへの ハン ドル 

機 能 ► 

々レント アニメー ション ポートに 登録され ている samplelD で 指定され る 画 

像を、 ヒープ 上に 再配置 可能 ブロ ッ クを 作成して 梅納 し、 

その ハン ドルを 返す。 

再配置が 発生す る。 

C の 関数 > 

Handle  VMGetSample  (long  samplelD) ; 

返り 値は 画 傑 データへの ハン ドル。 

エラーが 発生した 場合、 NULL が 返る。 

$A73D 

VMGetBits 

1  3.0 

引 数 ►  long  samplelD  ; サンプル ID 

返り 値 ►  DO.L  リ ザル トコ ー ド 

AO.L  ビッ ツ への ハン ドル 

機 能 ►  カレント アニメーション ポート じ 登録され ている samplelD で 指定され る 画 
像を、 ビッッ を 作成して 格納し、 その ハンドルを 返す。 

再 配 蘆が 発生す る。 

C の 関数 ►  Bits  VMGetBits ilong  samplelD) ; 

返り 値は ビッ ツ への ハン ドル。 

エラー が 発生した 場合、 NULL が 返る。 
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$A73E  VMInsertFrame  I  日. 日 


引 

数 

Ion 良 

samulelD 

; サンプル ID 

long 

loc 

； 禪入 位置の フレーム 番号 

long 

duration 

； 表示 時間 

返り 値 ► 

DO.L 

リ ザル トつ 

ー ド 

機 

能- 

々レン ト アニメ ー シヨ : 

ン ポート に 登録され ている sample  ID で 指定され る 画像 

を、 loc で 指定され る 位置の フ レームの 前に duration の 表示 時間を 持たせて 
碑 入す る。 

loc の範 聞は 0  <  loc  <  (枚数- 1) で、 -1 は 末尾を 意味す る。 
duration  の 単位は  tv(l/TimeScale  秒。 $A732  VMSetParam/ マクロ  VM 
SetTimeScale で 設定す る）。 

総 再生が 間が マクロ  VMSetDuration で 指定した 時間を 超え る 場合で も エラー 
にはなら ない が、 総 再生 時間を 超過 I した 部分は 表示され ない。 

1 つの 画像を 何度 指定しても かまわない。 

最初に 画像を 登録す る 場合、 loc と して- 1 を 指を する。 

再配置が 発生す る。 

C の 関数 ► 丄 on 呂  VMinsertFrame ( 1 ong  samplelD, long  loc, long  duration) ; 
返り 値は リ ザル トコ ー ド。 


$A73F  VMDeleteFrame  |_3.〇 


引 数*" long  loc  ; 挿入 位置の フレーム 番号 

返り 値 ►  D0.L  削除され たフ レー ム 番号/リザルト コード 

機 能 ►  々レン ト アニメーション ポートに 登録され ている loc で 指定され た フレームを 
削除す る。 

再配置が 発生す る。 

C  の 関数 ► long  VMDeleteFrame  (long  loc); 

返り 値は、 削除され た フレーム 番号 または リザ ル トコ ー ド。 


$A740  VMTimeToFrame  し 3.0 


引 数 ► long  chkTime  ; 該当する フレームが 号を 調べる 時刻 

返り 値 ►  DO.L  フレーム 番号/リザルト コード 

AO.L  該当する フ レー ム の 表示 酬始 時刻 

機能 ►  ChkTime で 指を する 時刻に 表示 中と なる フ レー ム のを 号を 返す。 

ChkTime  の 単位は  tv(l/TimeScale  秒。 $A732  VMSetParam/ マクロ  VMS et 
TimeScale で 設定す る）。 

C  の 関数 ► long  VMTimeToFrame  (long  chkTime,  long  幸 f  rameStartTi  皿 e) ; 

long 型の 変数 frameStartTime にフ レー ムの 表示 開始 時刻が 格納され る。 
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返り 値は、 フレーム 番号 または リザルト コード。 


$A741  VMFrameToSample  I  3 .日 


引 数 ► long  f rameNo  ; フレームを 号 

返り 値 ►  D0.L  サンプル の/ リザ ル トコー ド 

機 能 ►  カレント アニメーシヨ ン ポートで アニメー シヨン 再生す る 際に、 frameNo で 指 
定 される フレーム で 表示 される 画像の サン プル ID を 返す。 

C の 関数 ► long  VMFrameToSampledong  frameNo) ; 

返り 値は、 サンプル ID または リザルト コード。 


$A742  VMTrans  I  3.D 


引 

数- 

long 

sAnimHdl 

； 転送 元 アニメ ーシヨ 

ンポ ー ト への ハン ドル 

long 

dAnimHdl 

； 転送先 アニメ ー シヨ 

ンポ ー ト への ハン ドル 

返り 値 ► 

DO.L 

リ ザル トコ ー ド 

機 

能*^ 

sAiii 皿 Hdl です 旨定 さ； る 了ニメ 

—シ ヨン ポート から dAnimHdl で 指定 される ア 

ニ メーシ ョン ポート へ、 内容を コピー する。 主として、 メモリ モ_ ドの アニメー 
ショ ン ポー トの 内容を ディ スク モー ドの アニメ ー ショ ンポー トへ コピー （セー 
ブ）、 または その 逆 （ロード） に 使用す る。 

転送先が ファイル モー ドの 場合、 ファイルを read/write モー ドで 才ー プン して 
おく 必要が ある。 

メモリ 不足、 ディスクへの アクセス 失敗 等の 理由で コピーに 失敗した 場合の み、 転 
を 先の アニメーション ポート は 破壊 さ 知 リ ザル トコ ー ドと して ER_TRANS($FFF 
FFB11 = -1263) が 返る。 

画像 データ と サンプル のの 対応 関係は 変化し ない。 メモリ 今 ファイルの 転送 
の 際、 フレーム じ 対応す る 画像が 削除され ていた 場合には、 転送先には 0 バイ 
卜の 画像 データが 格納され る。 

再 配 蘆が 発生す る。 

C の 関数 ► long  VMTrans (Handle  sAnimHdl , Handle  dAnimHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A743  VMPlay  [~^ 


引 数 ►  long  animHdl  ; アニメーション ポートへの ハンドル 

long  rectPtr  ; レク タング ル レコー ドへの ポインタ （ロー 

々ル 座標系） 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 >  々レント ビットマップの rectPtr で 指を した 領域に、 animHdl で 指定した ア 


ビデオ マン 


530 


ビデオ マン 


ニ メー シヨ ン ポートの 内容の 再生を f 铜始 する。 

アニメーション ポートは クローズ 状態で なければ ならない。 

画像 デー タの レ クタ ン グルと rectPtr の 大き さが 異なる 場合は お大 / 縮小を 斤 

う 。 

再配置が 発生す る。 

C の 関数 ► long  VMPlay ( H andl e  ani 田扫 dl, Rect  れ ectPtr) ; 

返り 値は リ ザル トコ ー ド。 


$A744  VMEvent 


引 数- 


返り 値 ► 


機 台^ 


Ion だ  animHdl  ; アニメー シ ヨン ポート への ハンドル 

long  tsEventRec  ; タスク マン イベント レコードへの ポインタ 

D0.L  アニメー シヨ ンのが 態/リザルト コード 

0  アニメー シヨン 中 

1 [終了 

アイ ドル イベント 等で 呼び出す ことじ よって、 animHdl で 指定した アニメー 
シヨン ポートの 内容の アニメー シヨ ン化理 を 斤う。 tsEventRec じは、 そのと 
きの イベント レコ ー ド への ポインタ を 指定す る。 

アニメ ーショ ンを 再生す る グラフ レコードを カレン ト にしておく 必要が ある。 
再配置が 発生す る。 


C  の 関数 ► long  VMEvent  (Handle  animHdl , TsEvent  *tsEventRec) ; 
返り 値は、 アニメ ー シヨ ン のが 態 または リザ ル ト コード。 


$A745  VMS  top  I  3.0 


引 数 ► long  animHdl  ; アニメー ション ポート への ハンドル 

返り 値 ►  DO.L  リ ザル トコ ー ド 

機 能 ►  animHdl で 指定した アニメー ション ポート の アニメー ション 再生を 停止す る。 
C の 関数 ► long  VMStop (Handle  animHdl) ; 

返り 値は リ ザル トコ ー ド。 


$A746  VMPause 


引 数 ►  1011 良  animHdl  ; アニメー シ ヨン ポートへの ハンドル 

long  pauseLvl  ; ポ——ズ レベルの カロ^も を 

返り 値 ►  DO.L  前の ポーズ レベル 

機 能 >  現在の ポーズ レベルに pauseLvl で 指定した 値を 加え、 結果が 負で ある 場合、 
animHdl で 指定した アニメー シヨ ンポ ートの アニメー シヨン 再生を 一時停止す 
る。 ポーズ レベルの デフォルト値は 0。 
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pauseLvl として 0 を 指定す ると、 現在の ポーズ レベルを 返す。 
C の 関数 ► long  VMPause (Handle  animHdl , long  pauseLvl) ; 


返り 値は 前の ポーズ レベル。 

$A747 

VMUpdate 

1  3.0 

引 数 

返り 値 ► 

long  animHdl 

DO  •  L  リ ザル トコー ド 

; アニメー ション ポート への ハン ドル 

機 能- 

animHdl で キ宣定 した 了 ニ メー 

在 表示 中 の 画像を 再 表示す る。 
再配置が 発生す る。 

ション ポートの アニメー ション 再生に おいて、 現 
表示 中の 画像がない 場合は- 1 が 返る。 

C の 関数 > 

long  VMUpdate  (Handle 
返り 値は リ ザル トコ ー ド。 

animHdiJ  ; 

$A748 

VMSetUser 

1  3.0 

引 数 

返り 値 

long  dataHdl  ; 設定す る デー タが 格納され ている ブロック 

への ハン ドル 

D0.L  リ ザル トコ ー ド 

AO.L  アニメ ー シヨ ン ポート に 設定され た デー タへの ハン ドル 

機能- 

々レント アニメーシヨ ン ポートの ユーザ データと して、 dataHdl で 指定した 
ブロック じ 格納され ている 情報を 設定す る。 それ la 前に 設定され ていた ユーザ 
データの ブロック は 廃棄され る。 

dataHdl として NULL を 指定した 場合、 ユーザ データを 削除す る。 

再配置が 発生す る。 

C の 関数 ► long  VMSet User ( Handl e 
返り 値は リ ザル トコ ー ド。 

dataHdl; ; 

$A749 

VMGetUser 

1  3.0 

引 

数 

なし 

返り 値 ► 

DO.L 

リ ザル トコー ド 

AO.L 

アニメ ー シヨ ン ポート に 設定され ている ユーザ デー タへの ハン ドル 

機 

能- 

々レン ト アニメ ー シヨ ン ポー トの ユーザ データと して 設定され ている ブロック 

の ハン ドルを 返す。 

ブロ ックの 内容の 変更 や ブロ ックの サイ ズの 変更は 可能 だが、 廃棄して はなら 
ない。 変更 後は、 その ハンドルを 指定して $A748  VMSetUser しなければ なら 
ない。 

C の 関数 ►  Handle  VMGetUser(void) : 
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返り 値は ユーザ データへの ハン ドル。 
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$A74A  VMDisplay 


E3.0 


引 数 ►  long  animHdl  ; アニメーション ポート への ハンドル 

返り 値 ►  D0.L  リザルト コード 

機 能 ►  animHdl で 指定した アニメー ショ ンポ ートが アニメー ション 再生 中 あるいは ク 
ローズ 状態で ある 場合、 現を 時刻に 表示すべき 画像を 表示す る。 現を 表示 中の 
画像と 同 じで ある 場合は 表示し ない。 

再配置が 発生す る。 

C  の 関数 ► long  VMDisplay  (Handle  animHdl) ; 

返り 値は リ ザル トコ ー ド。 


マクロ  VMSetDuration 


定 義^  #define  VMSetDuration(dur)  VMSetParain(PARAM_DURATION ,  dur) 


引 数- 
返り 値 


機能- 


VMSetDuration 

虹る cro 

dur 

move . 1 

dur,-(sp) 

move . 1 

#0,-(sp) 

♦  PARAM.DURATION 

SXCALL 

$A732 

♦  VMSetParam 

addq . 1 

#8,sp 

endm 

long  dur 

； 総 再生 時間 

DO.L  負の 値の 場合は エラー 

A0.L  前の 設定 値 

グロー バル 系に おける 総 再生が 間を dur にす る。 単位は tv(l/TimeScale 秒。 
$A732  VMSetParam/ マクロ  VMSetTimeScale  で 設定す る）。 


マクロ  VMSetTimeScale 


ま 

義- 

#def ine  VMSetTimeScale (seal) 

VMSetParam (PARAM.TIMESCALE ,  seal) 

VMSetTimeScale 

macro 

seal 

move . 1 

seal,— (sp) 

move . 丄 

#l,-(sp) 

*  PARAM_TIMESCALE 

SXCALL 

$A732 

*  VMSetParam 

addq . 丄 

#8,sp 

endm 

引 

数- 

long  seal 

夕 

タ イム スケー ル 

返り 値 ■- 

DO.L  負の 値の 場合は エラー 
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AO.L  前の 設定 値 

機 能 ►  グローバル 系に おける タイム スケールを seal にす る。 これに よって、 時間の 
単位で ある tv  (Time  Value) 力ぶ 1/TimeScale 秒と なる。 


マクロ 

VMSetRate 

定 義》" 

#def ine  VMSetRate (rate) 

VMSetParamC P ARAM_ RATE ,  rate) 

VMSetRate  macro 

rate 

move . 1 

rate,- (sp) 

move . 1 

#2,-(sp)  ♦  PARAM_SETRATE 

SXCALL 

$A732  *  VMSetParam 

addq . 1 

#8,sp 

endm 

引 数- 

long  rate 

； スピ ー ドレ ー ト 

返り 値 

DO.L  負の 値の 場合は エラー 

AO.L  前の 設定 値 

機 能 ► 

グロー バル 系に おける ス ピー ドレ 

—卜を rate にす る。 

マクロ 

VMS et Cur Time 

を 義^ 

#def ine  VMSetCurTime (tv) 

VMSetParam (PARAM.CURTIME ,  tv) 

VMSetCurTime  macro 

tv 

move . 1 

tv,-(sp; 

move . 1 

#3,-(sp)  *  PARAM_CURTIME 

SXCALL 

$A732  *  VMSetParam 

addq . 1 

#8,sp 

endm 

引 数- 

long  tv 

； 現在 時刻 

返り 値 ► 

DO.L  負の 値の 場合は エラー 

AO.L  前の 設定 値 

機 能- 

グローバル 系に おける 現在 が 刻 を 

■  tv にす る。 単位は tv(l/TimeScale 秒。 

$A732  VMSetParam/ マクロ  VMSetTi 皿 ©Scale  で 設定す る）。 

マクロ 

VMSetPlayRect 

定 義^  #define  VMSetPlayRect (rectPtr) VMSetParain(PARAM_PLAYRECT,rectPtr) 
VMSetPlayRect  macro  rectPtr 

move . 1  rectPtr, -(sp) 

move.l  #7,-(sp)  *  PARAM_PLAYRECT 
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SXCALL 

$A732  *  VMSetParam 

addq . 丄 

#8,sp 

e 凸 dm 

引 

数 

long 

rectPtr 

; レク タング ル レコー ドへの ポインタ 

返り 値 ► 

DO.L 

負の 値の 場合は エラー 

A0.L 

前の レク タング ル レコ 

ー ド への ポインタ 

機 

能- 

画像の 再生 レク タング ルを rectPtr で 指ました レク タング ル じする。 

マクロ 

VMSetUserAto 皿 

定義- 

#def ine  VMSetUserAtom(hdl) 

VMSetParamC PARAM_USERATOM , hdl) 

VMSetUserAtom  macro 

hdl 

move . 1 

hdl,- (sp) 

move . 1 

#8,-(sp)  *  PARAM.USERATOM 

SXCALL 

$A732  *  VMSetParam 

addq . 1 

#8,sp 

endm 

引 数- 

long  hdl 

; ユーザ データへの ハン ドル 

返り 値 ► 

DO.L  負の 値の 場合は エラー 

AO.L  前の ユーザ デー タ への ハン ドル 

機能 

ユーザ データへの ハン ドルを 設定す る。 

マクロ 

VMGet Dur at i on 

定義- 

#def  ine  VMGetDurationO 

VMGetPar  am  (PARAM_DURATION) 

VMGetDuration  macro 

move . 1 

#0,-(sp) 幸  PARAM_DURATION 

SXCALL 

$A733  *  VMGetPar am 

addq . 1 

#4,sp 

endm 

引 数- 

なし 

返り 値*^ 

DO.L  貪の 値の 場合は エラー 

AO.L  総 再生 時間 

機能- 

グローバル 系に おける 総 再生 時間を 返す。 単位は tv(l/TimeScale 秒。 $A732 
VMSetParam/ マクロ  VMSetTi 皿 ©Scale  で 設定す る）。 

マクロ 

VMGetTimeScale 

定 義^  #define  VMGetTimeScaleO  VMGetPar am (PARAM_TIMESCALE) 


535 


ビデオ マン 


VMGetTimeScale 


macro 

田 ove . 1 

#l,-(sp) 

SXCALL 

$A733 

addq . 1 

#4,sp 

endm 

♦  PARAM.TIMESCALE 
幸  VMGetParam 


引 数 ► 
返り 値 ► 

機 能 > 


なし 

DO.L 

AO.L 

グロー 


負の 値の 場合は エラー 
タ イム スケール 

バル 系に おけ る タイ ムス ケ ー ルを 返す。 


マクロ 

VMGetRate 

定義- 

#def ine  VMGetRate () 

(long) VMGetParam (PARAM_RATE) 

VMGetRate  macro 

扭 ove . 1 

#2,-(sp) 

幸 

PARAM-RATE 

SXCALL 

$A733 

幸 

VMGetParam 

addq . 1 

#4,sp 

endm 

引 数 

なし 

返り 値 

DO.L  負の 値の 場合は エラー 

AO.L  スピード レート 

機 能- 

グロー バル 系に おける ス ピー ドレ 

—卜 を 返す。 

マ タ D 

VMGetCurTime 

定 義^ 

#def ine  VMGetCurTime () 

VMGetParain(PARAM_CURTIME) 

VMGetCurTime  macro 

田 ove . 1 

#3,-(sp) 

本 

PARAM_CURTIME 

SXCALL 

$A733 

幸 

VMGetParam 

addq . 1 

#4,sp 

endm 

引 数- 

なし 

返り 値- 

DO.L  負の 値の 場合は エラー 

AO.L  現在 時刻 

機 能 ►  グロー バル 系に おける 現在 時刻を 返す。 単位は tv(l/TimeScale 秒。 $A732 
VMSetParam/ マクロ  VMSetTimeScale  で 設定す る）。 


ビデオ ミ 


536 


ビデオ マン 


マ タ 〇 

VMGetPlayRect 

定 義> 

#def ine  VMGetPlayRect (rectPtr) VMGetPcLram(PARAM_PLAYRECT,rectPtr) 

VMGetCurTime  macro 

rectPtr 

move . 丄 

rectPtr , -(sp) 

田 ove . 1 

#7,-(sp)  *  PARAM_PLAYRECT 

SXCALL 

$A733  *  VMGetParam 

addq . 丄 

#8,sp 

endm 

引 数- 

long 

rectPtr 

； 結果が 返る レク タング ル レコー ドへの ポイ 

ンタ 

返り 値 ► 

DO.L 

負の 値の 場合は エラー 

AO.L 

再生 レク タング ルの レク タング ルレ コー ドへの ポイ ンタ 

機 能- 

画像の 再生 レ クタ ン グルを 返す。 

マクロ 

VMGetUserAtom 

定義- 

#def ine  VMGetUser Atom ( ) 

VMGetParam ( PARAM_USERATOM) 

VMGetUserAtom  macro 

虹 OV 色. 1 

#8,-(sp)  *  PARAM.USERATOM 

SXCALL 

$A733  *  VMGetParam 

addq . 1 

#4,sp 

endm 

引 数- 

なし 

返り 値 ► 

DO.L 

負の 数の 場合は エラー 

AO.L 

ューザ データへの ハン ドル 

機能 

ューザ データへの ハン ドルを 返す, 

0 

マクロ 

VMGetWidthHeight 

定 義>  #define  VMGetWidthHeight  〇  (point_t)VMGet:Param(PARAM_WIDTHHEIG 肌） 
VMGetWidthHeight  皿 aero 


虹 ove . 1 

#$1000, -(sp) 

♦  PARAM-WIDTHHEIGHT 

SXCALL 

$A733 

*  VMGetParam 

addq . 1 

#4,sp 

endm 

引 数 なし 

返り 値 ►  DO.L  負の 数の 場合は エラー 

AO.L  アニメ ー シヨ ン 画像の 縦横 幅を 意味す る ポイント 
機能- アニメーション 画像の 縦横 幅を 返す。 
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マクロ 


VMGetStatus 


ま義 I 


#def ine  VMGetStatus () 
VMGetStatus 


VMGetParam(PARAM_STATUS) 


macro 

move . i 

#$1001, -(sp) 

SXCALL 

$A733 

addq . 1 

#4,sp 

endm 

*  VMGetParam 


引 数- 
返り 値 ► 


なし 

DO.L 

AO.L 


負の 数の 場合は エラー 
アニメ ー シヨ ン ポートの 状態 


0 

クロー ズが態 

1 

オープンが 態 

2 

アニメー シヨ ン中 

機 能- アニメーション ポート のが 態を 返す。 


マクロ 


VMGetMediaMode 


定義 I 


引 数 I 
返り 値 I 


#define  VMGetMediaMode () 

VMGetParam (PARAM_M 邸 lAMODE) 

VMGetMediaMode  macro 

面 ove . 1 

#$1002, -(sp) 

幸  PARAM-MEDIAt 

SXCALL 

$A733 

*  VMGetParam 

addq . 1 

#4,sp 

endm 

なし 

D0.L 

A0.L 


負の 値の 場合は ェ ラ- 
メ  ディ  アの 種類 


0 


メモリ モード 
ファイル モード （変更 中） 
ファイル モード 


機能 ► 画像 メディアの 種類を 返す。 


マクロ 


VMGetFrameDuration 


定 義 I 


#define  VMGetFrameDurationCfrm)  VMGetParam (PARAM_FRAMEDUR , f rm) 
VMGetFrameDuration 


*  VMGetParam 


面る cro 

fr 皿 

move . 1 

fr 皿，- (sp) 

move . 1 

#$1003, -(sp) 

SXCALL 

$A733 

addq . 1 

#8 ,  sp 
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endm 
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引 数 ► long  frm  ; フレームを 号 

返り 値 ►  D0.L  負の 値の 場合は エラー 

A0.L  再生 時間 

機 能 ►  frm で キ旨定 した フレームの 再生 時間を 返す。 単位は tv(l/TimeScale 秋 $A732 
VMSetParam/ マクロ  VMSetTi 皿 eScale  で 設定す る）。 


マクロ 

VMGetTotalSample 

を義- 

#def ine  VMGetTotalSample () 

VMGetParam  (PARAM_TOTALSAMPLE) 

VMGetTotalSample  macro 

面 ove . 1 

#$1004, -(sp) 

*  PARAM.TOTALSAMPLE 

SXCALL 

$A733 

*  VMGetParam 

addq . 1 

#4,sp 

endm 

引 数- 

なし 

返り 値 

DO.L  負の 値の 場合は エラー 

AO.L  総 サンプル ID 数 

機能 > 

総 サンプル ID 数を 返す。 

マクロ 

VMGetCurSample 

定義- 

#def ine  VMGetCurSample ( ) 

VMGetParam  (PARAM.CURSAMPLE) 

VMGetCurSamD 丄 e  皿 aero 

move . 1 

#$1005, -(sp) 

♦  PARAM_CURSAMPLE 

SXCALL 

$A733 

*  VMGetParam 

addq . 1 

#4,sp 

endm 

引 数- 

なし 

返り 値 

DO.L  負の 値の 場合は エラー 

AO.L  カレントの サンプル ID 

機能 > 

々レント のサ ン プル ID を 返す。 

マクロ 

VMGetTotalFrame 

ま 義^  #def  ine  VMGetTotalFrame  () 
VMGetTotalFrame  皿 aero 


扭 ove . 1 

SXCALL 


VMGetParam (PARAM_TOTALFRAME) 

#$1006, -(sp)  *  PARAM_T 日 TALFRAME 

$A733  幸  VMGetParam 
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addq . 1  #4 , sp 

endm 


引 

数- 

なし 

返り 値 ► 

D0.L  負の 値の 場合は エラー 

A0.L  総 フレーム 数 

機 

能 

総 フレーム 数を 返す。 

ライブラリ  VMSetParam 


引 数 ► long  paramID  ; 設定す る パラメータの ID 

:  ； 設定 値 

返り 値 ►  前の 設定 値 

機 能 ►  paramID で 指定した 内容 じついて、 値の 設定を 巧う。 

脚 数の プロ ト タイプ 宣言では、 第 2 引数で 各 穂の 型を 化理 でき るよう じ 可変長 
引数を 用いて 宣言され ている が、 ライブ ラ リ では 引数を 必ず 2 つ 持つ 関数と し 
て 実装して いるた め、 実際に 使用す る 場合は マクロを 使用し なければ ならな L、。 
C の 関数 ► long  VMSetParam ( long  paramID,  •••); 


ライブラリ  VMGetParam 


引 数 ►  long  paramID  ; 参照す る パラメー タの ID 

返り 値 ►  前の 設定 値 

機 能 ►  paramID で 指定した 巧を について、 設定され ている 値を 返す。 

SX コールと 引数が 興なる 場合が ある。 通常、 引数は 1 つで あるが、 $A733 
VMGetParam では、 第 1 引数 力ぶ PARAM—PLAYRECT  ならびに  PARAM.FRAMEDUR 
の 場合の み、 2 つの 引数が 必要で ある。 これらの パラメータ について 値を 参照 
する 場合は、 マクロ  VMGetParain2 を 用いなければ ならない。 

実際 じ 使用 する 場合は、 マクロ を 使用し な ければ ならない。 

C の 関数 ► long  VMGetParam ( long  paramID); 


ライブラリ  VMGetParam2 


引 数 ►  long  paramID  ; 参照す る パラメータの ID 

返り 値 ►  前の 設定 値 

機 能 ►  paramID で 指定した 巧を について 設定され ている 値を 返す。 

この f 詞 数は、 PARAM-PLAYR 巨 CT ならびに PA 托 AM_FRAMEDUR の 2 つの パラ 
メータの 内容を 参照す る 場合 にかぎ り、 使用す る こと が 可能。 

実際に 使用す る 場合は、 マクロ を 使用し な ければ なら ない。 
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C の 関数 ► long  VMGetParam2 (long  paramlD, 
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$A0AA  EMLStill . 246 

$A0AC  EMLWait . 247 

$A0B3  EMMaskSet . 248 

$A0A7  EMMSLoc . 246 

$A0A9  EMRBttn . 246 

$A0AB  EMRStill . 246 

$A0AD  EMRWait . 247 

$A0A6  EMScan . 245 

$A0A4  EMSet  . 244 

$A0AF  EMSysTime . 247 

$A0A3  EMTini . 244 

$A074  EXAni  皿  End . 236 

$A073  EXAnimSt  art . 236 

$A075  EXAni 皿 Test  . 236 

$A069  EXDeVDISPST . 231 

$A068  EXEnVDISPST . 231 

$A  巨 OA  FMFontMenuSelectC 理] . 497 

$A504  FMGetChacheSizeEZnH . 496 

$A502  FMGetFontList  広 E . 495 

$A50B  FMCetFontPolyPatal 2.0  I . 498 

$A509  FMGetKerningWidth 匹 E . 497 


$A506  FMGetSpaceWidt  址 I 丑 . 496 

$A508  FMGetTrackingCZn] . 497 

$A500  FMInitCZE . 495 

$A503  PMSetChacheSizeLLOJ . 496 

$A  己 05  FMSetSpaceWidt  址 I 面 . 496 

$A507  FMSetTrackingLZiJj . 497 

$A501  FMTini™ . 495 

$A1E0  GMAddFont . 314 

$A1D4  GMAdjustPt  . 310 

$A159  GMAdjustRect . 271 

$A154  GMAndRect . 269 

$A1D8  GMAndRectRgn . 311 

$A150  GMAndRect  s . 267 

$A164  GMAndRgn . 275 

$A149  GMAPage . 265 

$A148  GMBackColor . 265 

$A566  GMBackRGBSE . 330 

$A1C8  GMCalcBitmap . 306 

$A1B2  GMCalcFrame . 299 

$A1D1  GMC  ale  Graph . 309 

$A1B1  GMCalcMask . 299 

$A1C9  GMCalcScrnSize . 306 

$A1D6  GMCenterRect . 310 

$A1DC  GMCharKind . 313 

$A194  GMCharWidth . 290 

$A13A  GMClipRect . 261 

$A12E  GMCloseGraph . 258 

$A19F  GMClosePoly . 294 

$A15D  GMCloseRgn . 272 

$A19A  GMCloseScript . 292 

$A17F  GMCopy . 283 

$A560  GMCopy2 屈 D . 328 

$A133  GMCopyGraph . 259 

$A180  GMCopyMask . 284 

$A160  GMCopyRgn . 273 

$A1B9  GMCopyStdProc . 302 

$A1C3  GMCurFont . 305 

$A1DA  GMDi  壬  fRectRgn . 312 

$A166  GMDiffRgn . 275 

$A1DD  GMDiff  RgnRect . 313 

$A1CB  GMDisposeBits . 307 

$A1A0  GMDisposePoly . 294 

$A15B  GMDisposeRgn . 272 


554 


$A19B  GMDisposeScript . 293 

$A455  GMDitherlmgLiLi . 319 

$A544  GMDrawBezierCZH] . 321 

$A545  GMDrawBSpline  阻 E . 322 

$A18F  GMDrawChar . 289 

$A1AD  GMDrawGie . 298 

$A1E9  GMDrawGsOne  圧 E . 315 

$A19C  GMDrawScript . 293 

$A563  GMDrawScript2[33Il . 329 

$A191  GMDrawStr . 289 

$A190  GMDrawStrL . 289 
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$A186  GMDupHImg . 286 

$A188  GMDupHRImg . 287 
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$A146  GMExPat . 265 

$A179  GMFillArc . 282 

$A1BD  GMFilllmg . 303 

$A56A  GMFmimg2 皿 . 331 

$A1EC  GMFillNPoly 丘 丑 . 316 

$A175  GMFillOval . 280 

$A17D  GMFillPoly . 283 

$A173  GMFillRect  . 280 

$A17B  GMFillRgn . 282 

$A1BC  GMFillRImg . 303 

$A569  GMFillRImgS  皿 . 331 

$A177  GMFillRRect . 281 

$A18C  GMFontFace . 288 

$A198  GMFontInfo . 292 

$A18B  GMFontKind . 287 

$A18D  GMFontMode . 288 

$A56D  GMFontRealSize  巧の . 332 

$A18E  GMFontSize . 288 

$A147  GMForeColor . 265 

$A565  GMForeRGBI  3.0  1 . 329 

$A178  GMFrameArc  . 281 


$A1EB  GMFrameNPolyLEJLI . 316 

$A174  GMFrameOval . 280 

$A17C  GMFramePoly . 282 

$A172  GMFrameRect . 279 

$A17A  GMFrameRgn . 282 

$A176  GMFrameRRect . 280 

$A1D0  GMFreeBits . 308 

$A1C7  GMGetBitmap . 306 

$A543  GMGetBSDepth 屈！] . 321 

$A54B  GMGetBSErrorCIS] . 324 
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$A1E8  GMGetRgnProcTbl . 315 

$A19D  GMGetScript . 293 
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$A1C4  GMGetScrnSize . 305 

$A1E6  GMGetStdProcTbl . 315 
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$A1AB  GMInitPalet . 298 

$A140  GMInitPen . 262 

$A153  GMInsetRect . 269 

$A163  GMInsetRgn . 274 

$A1A5  GMInvertBits . 295 

$A1A3  GMInvertRect . 295 

$A1CE  GMItalicRect . 308 

$A1CF  GMItalicRgn . 308 

$A170  GMLine . 279 

$A171  GMLineRel . 279 

$A13E  GMLocalToGlobal . 262 

$A1CC  GMLockBits . 307 

$A562  GMMcLkeGrpBitmapLJLQJ . 328 

$A56C  GMMakePaletl  3.0  1 . 332 
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$A1A6  GMMapPt . 296 

$A1A7  GMMapRect . 296 

$A1A9  GMMapRgn . 297 

$A16E  GMMove . 278 
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$A161  GMMoveRgn . 274 
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$A15A  GMNewRgn . 272 

$A1F3  GMNLineCSD . 319 
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$A1EE  GMPolyFlRgnEZE . 317 

$A1ED  GMNPolyFrRgn 口 丑 . 316 

$A14E  GMNullRect  . 267 

$A15E  GMNullRgn . 273 

$A12D  GMOpenGraph . 258 

$A19E  GMOpenPoly . 294 

$A15C  GMOpenRgn . 272 

$A199  GMOpenScript . 292 

$A155  GMOrRect . 270 

$A1D9  GMOrRect  Rgn . 312 

$A165  GMOrRgn . 275 

$A1D2  GMPackImage . 309 

$A1BF  GMPaintRgn . 304 
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$A144  GMPenMode . 264 

$A145  GMPenPat . 264 

$A141  GMPenShow . 263 

$A143  GMPenSize . 263 
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マクロ  VMSetPlayRect . 534 

マクロ  VMSetRate . 534 

マクロ  VMSetTimeScale . 533 

$A748  VMSetUseiQS： . 532 

マクロ  VMSetUserAtom . 535 

$A745  VMStopCSD . 531 

$A740  VMT imeToFramel  3.Q.J . 529 

$A701  VMTini  皿 . 517 

$A742  VMTrans  皿 . 530 

$A747  VMUpdate  皿 . 532 

$A230  WHGetm . 351 

$A22F  WHOpe  旭 皿 . 350 

$A20F  WMActive . 345 

$A218  WMAddRect . 345 

$A219  WMAddRgn . 346 

$A223  WMCalc  邸  dtCM] . 348 

$A 200  WMCarry . 340 

$A20A  WMCheckBox . 344 

$A20B  WMCheckCBox . 344 

$A1FB  WMClose . 338 

$A1FC  WMDispose . 339 

$A205  WMDrag . 342 

$A225  WMDragRgn . 349 

$A20C  WMDrawGBox . 345 

$A1FD  WMFind . 339 

$A224  WMGetDTGS . 349 

$A 204  WMGrow . 342 

$A21D  WMGScriptGet . 347 

$A21C  WMGScriptSet . 347 

$A208  WMHide . 343 

$A1F8  WMInit . 337 


$A232  WMMargineGetLiflJ . 352 

$A233  WMMargineSet  巧 面 . 352 

$A202  WMMove . 341 

$A235  WMMove2Sn： . 353 

$A1F9  WMOpen . 337 

$A231  WM0pen2 丘 E . 351 

$A22C  WMOptionGet . 350 

$A22D  WMOptionSet . 350 

$A222  WMPinRect™ . 348 

$A22E  WMPtIn  郎 ox . 350 

$A1FA  WMRefer . 338 

$A1FE  WMSelect . 340 

$A1FF  WMSelect2 . 340 

$A201  WMShine . 340 

$A207  WMShow . 343 

$A209  WMShowHide . 343 

$A203  WMSize . 341 

$A21A  WMSubRect . 346 

$A21B  WMSubRgn . 346 

$A221  WMTIDGet . 348 

$A220  WMTIDSet . 348 

$A21F  WMTitleGet . 347 

$A21E  WMTitleSet  . 347 

$A20D  WMUpdate . 345 

$A20E  WMUpdtOver . 345 

$A206  WMZoo 田 . 343 

$A228  WSClose . 354 

$A22B  WSDelist . 355 

$A229  WSDispose . 354 

$A22A  WSEnlist . 355 

$A227  WSOpen . 354 
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早い も ので X68000 が 誕生して か らもう 9 年 近く。 その 半分は SX-WINDOW 
の 歴史で もあります。 この 5 年間、 たくさんの 人が、 その 人な りの やりかたで 
SX-WINDOW とつき あってき ました。 FSX.X を 解析す る 人、 実用 アプリ ケー 
シ ョンを 作る 人、 小物 ソフトで デスクトップを 飾る 人、 環境の カスタマイズに 命 
を 賭ける 人、 開発 環境を 作る 人。 そして そんな 人たち とともに SX-WINDOW を 
支えて きた たくさんの 人たち。 この 人たち の 形作って きた 仮想 的な 「場」 には、 
確かに ひとつの 文化が 存在し ます。 よくいえば 「ユーザ 主導」、 ありてい にいう 
ならば 「メー々 の イニシアチブ 不足」 ゆえの 文化です が、 これは これで 結構 楽 
しい。 …… などと いっている わたしたちの ような 人間が いるから、 いつまでも メ 
ジャーに なれない のか も しれません が。 

しかし ひとつ だけ 確かな ことは、 ユー ザの 努力、 そして、 地道に サポートを 続け 
てきた メ ーカの 努力が こ れ だけの 义 化を 化 關 かせた という ことは、 日 本の パソコン 
史 のなかの ひとつの 奇跡で あると いう こ とです。 本書で 提供す る SX-WINDOW 
の 開発 環境 や、 CD-ROM じ 収められた フ リー ソフト は その 奇跡の ほんの 一部で 
しかありません。 なぜなら、 奇跡は あなたが 作った SX-WINDOW アプリ ケー 
ショ ンが 加わる こと で 完全な ものと なる から です。 

本書と いう 小さな 奇跡に ご 協 力いた だいた 皆さん に 最上級の 感謝 を 込めて。 
フリーソフト ウェアの 収集なら びに その 紹介に み 力 していた だいた 葛 生 高 司 氏、 
LIBSXC の ほとんどの 改造を 手掛けた Niggle 氏、 callno  header の 作成を 手伝っ 
て くれた 松 森 ひろき 氏、 数々 の 助言を いただき、 また 深夜の 突然の 訪問に も 快く 
応じてく ださ っ た 沖 勝 氏、 多 機能 SCSI デ バイ ス ドライバ SUSIE の 添付を 快諾し 
てくだ さった 後藤 浩昭 氏に 感謝し ます。 そして、 uebee 氏、 lucas 氏、 ouzak 氏 
の 見返りを 期待し ない 善意に 感謝し ます。 そのほか、 書き きれない ほどた くさん 
の 人たち に、 心から 感謝いた します。 

"己が 窓を 開かれよ。 されば 世界は 己が 手に。" 
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(用語 索引 


記号- 数字 


巨 


-fa  丄 1-re  皿 ote  ►142, 144 

-SX-22 

.bss セクション  >22 
. data^22 

. rdata セ ク ショ ン >22,  23 

. rldata セ ク ショ ン >23 

_esta>l64 

_rbsta^l63 

_rdsta>i63 

_rlbsta>l64 

_rldsta>l64 

_rlssta>l64 

_rssta>l64 

_SSta>164 

-SXCALLP  れ  >118 

_SXCALLPtr«-ll5 

_SX_GETMEM_SIZE-151 

__MTEDIT_T-155 

__SX_GCC__-131 

__SX_INLINE__-113 

2 行 じする の .ifiyg 

3D グラフ .X^Ul 


BeepCh  anger .  x  ► 179 
brk  関数  >150 

c 

C++ コ ンパ イラ  >157 
calcSx.x>l93 
CALENDAR.X-m 
callno  header  ►21,  ill 
calino  header  ►so 
canvas  .r  ►IQS 
CCCV.X>177 

CD-ROM ドライブ >56 

cddata.x^l7l 

cddev.  sys>53,  55 

cg.bfd^l79 

CGA-104 

CGA>92 


3D 棒グラフ .X、 横棒 グラフ .X、 レー ダー型 グ 
ラフ 

55ED .  X  ►173 
65,536 色 表示  >92 


CGraph.X^m 
CHIDIR!  .X-193 
ClickMenu .  x  ► 180 
CLOSEWITHOUT.X-194 
CMFind  関数- 119 
common  修飾子 ► 147 
common  宣言  >22 
COPYBACK.X-194 
cplk.X>177 
CRTCTRL.r^m 


A-line  trap  ► 115 

A5 レジスタ 相対 ア ドレッシング- 166 

Active  J 皿  p.X>l79 

adi  .r>l79 

adpplay .  r -190 

arlk.x>l77 

autocase .X -193 


D 

DBCtr  .x>l74 
DirViewer  .x»-i95 
disk_inf  o.x>i83 
doc .  X>194 
DOS つール  >8 
DRVINFO. 氏- 183 


E 


e-c-brace . ex/ isearch . ex/opt ab . ex 

/ rpax . ex/ setkindl . ex/xclick. ex 
►180 

EMAGENCY.r-195 
errno  ► 148 
extdrag.r^iso 

F 

F2SC.X-195 
11 ie_info.x>i84 
FILEINFO.X-183 
f  ix.mv.r  ►180 

f  皿  e 皿 O.X*184 
FSX.X-4 

G 


iconwdef  .r>i89 

に 0%60 バ 7 

に 0%60 レベル 1 規格 バ 1 

IVM.LB-98 

IVM.X-98 

IVMInf  0  .x>l96 

IVM モジ ユール 削除 . X>198 

L 

LIBC-24, 128 
libc .  a>i3l 

LIBSXC>21,  25.  30. 128. 130, 159 

libsxc.a^l3l 

Ivcv.x,  IvcvOSO . X ► 177 

M 


G.ate  丄 ier.X>l86 
G_GRP タイプ  >100 
GARBAGE.  X- 195 
gCC>20,  21 
gcc2>21. 157 
GLMpatch.x>i86 
GMCopy2 関数  >1〇2 
GNU  C  compiler  パ〇 
gnuchess  .x-184 
gnus  .el/ ほ 力、 >192 

GOLFSW.PCM,  CASTA. PCM,  CUP.IN.PCM, 
SPRING. PCM,  SPLASH. PCM,  APL.PCM 

►184 

gr_sel  .x>i86 
grroot  .x>i86 
GRW.X-93 


MAKEGCC.BAT -78 

MAKEXC.BAT -78 

maki_if.r,  mak し ec.r >187 

田 alloc 関数  >130 

MC68000 -5 

MCZector  .x^l73 

MenuDesigner . x  ► 177 

MFOCK.X-196 

Mini  .x>l96 

MISA.X-176 

MKCS.X-184 

MMChPtrNew ► 151 

皿 oCDEF  .r  >189 

皿 0 田 ocopy  .x>202 

虹  vsi  .X>173 

N 


H 

HCDAD.SYS-181 
henwin2.x^l8l 
HisClip.  X-196 
Human68k  ►g 


NDS.X-197 
ne 皿 acs  .x>l78 
ng.x-lZQ 
nr  .X  ►192 
NULL -100 
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0 


DBJC 型 タスク- 12 
OB  JC 型 モジ ュール ► 149 
OB  JO 型 タスク- 12 
OB  JR 型  >82 
OB  JR 型 タスク  >11 
OB  JR 型 モジュール  >23, 147 
OB  JX 型 タスク  >12 
OpenDir !  .x>l97 
Overflow  error ►142 

P 

path.  x>  197 
picbtt  打 .r>l90 
PICICON.X-197 
PICTtoDRAW.x>-l98 
PiVM.X-187 
pOStSx  .X>173 
ps.x,  kill. X>  198 
pt4get  .x>l98 

Q 

QINT.X*-192 
QuTERM .  X  ► 192 
QuTERM_S.X-192 

R 

regse  る. ex>l98 
Relative  error ► 139 
remote>22 
REQRESPONSE-95 
roottoscrap  .x*-l99 
rscv.x>l78 

s 

SA 过 just  .r>l8l 
sample .  c  >77 
sample .h >77 
sample .X >78 
sbrk  関数  >150 


SCopy.x-199 
SCSt  .X>200 
SendMes.x^l99 
SeSS.x-177 
setdtop.x>l82 
SETUP. LB バ 9 
SETUP.  X- 59 

Silent Act ivate • X ► 182 
skeleton. c> 77 
SMAutoexec . x ► 199 
SNAP04.INS,  SNAP04.LB-182 
streamMan .  x  ►  200 
SUSIE -53 

SX31KIT>21， 29,  75, 155. 157 
SX-gnuplot • X ► 172 
SX-PITMAN.X-184 
SX-Sirtet  •  x>l85 
SX-Tatris  .x>l86 
SX-WINDOW-4, 10. 17 
SX_CRLF.X-201 
SX_GCC-I3l 
sx_grep.x>20l 
SX_logo.pan>i76 
SXAutoDir  .x-201 
sxBack.x>l99 
SXBdif  .x>20l 
SXBJ.X-201 

SXBOMB . x/SX2DMaze . x/SX3DMaze .x-l85 

SXBup.x-201 

SXCalc  .x^l73 

SXCALL-115 

SXCALL.EQU-157 

sxcall  .equ^ll2, 116 

SXCALL.H-157 

SXCALL.MA0157 

SXCALL  関数  119 

SXCALL  宣言  >22 

SXCDP.X-190 

SXCLIB-25 

SxCut  .  X  ► 199 

SXDEF.H>123 

SXdentaku .  x  ► 172 

SXerror  .x^i82 
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SXg2t  .X>200 

sxGallery . x ►200 

sxGFrame  .x>200 

SxGOLF.X-185 

sxgzip.x>l75 

SX 肥 レ 190 

SXINFO.R-184 

SXjis  .X>202 

sxkernel ►lAQ 

SXKIT-25 

SXLIB.H-123 

SXlisp.X>189 

SXman .  x  ►  202 

sxme  虹 0  .x>l74 

SXmic.x>202 

sx  皿 ode  .x>202 

SXMP.X-202 

SXPl.X-191 

SXP2.X-192 

SxPANIC.r^l88 

SXPerf  or  虹 . X>203 

SXperiod.x-181 

SXPIconv.x>l88 

SXpixpi  .x>l88 

sxqv .  X  ► 193 

SXREF.DIF-178 

SXREF.TXT -178 

SxSED.X バ 03 

sxsh.x>203 

sxtar  .x»-l75 

SXWAVPLAY.X-191 

sxwdb^l49 

SXWIN.X-4 

SXWS.X-182 

SXXX.X-175 

SXZC  .r  ►iQl 

SX クロ ン ダイク .X*^185 

SX コー ルバ 

SX シエ ル  >4 

SX システム  >4 

SX  青 海 .X>185 

SX  香港 .X>185 

SX モード ► 115, 131 


SYSDTOP.SX-68 

下 

TSEventAvail 関数  >95 
TSPostEventTsk  関数  >95 
TSSLIB-190 
TwentyOne .  X-36,  47.  57 
TXF.R-70 

u 


UNO.  LB -176 
updownlib>i90 

V 


VIDEO.  H- 156 
Videoinfo >99 
ViSON.x-175 
VMClose  関数  >108 
VMCompress  関数 ► 1〇2 
VMCreateF  関数  >105. 107 
vmcut . INS,  vmcut . LB ► 188 
VMEC-98 

VMEvent  関数- 106 
VMExpand 関数 パ〇〇 
VMGetInf  0 関数  >99 
VMGe  tWidthHe  ight  関数- 105 
VMGIF.INS,  VMGIF.LB-188 
VMIF-98 

vmii— 面 ag.r,  vmec— 皿 ag.r ►isy 
VMIF_SC8  VMEC_SC8-189 
VMInsertFrame  関数 ►108 
VMINSTALL.PEN-178 
vmp2 . INS ,  vmp2 . LB  ► 189 
VMPlay  関数- 106 
VMRegistSample  関数 ► 107 
VMSetDuration  関数 ►los 
VMSetTimeScale  関数  >  108 
vmzau.  INS,  vmzau.LB>l89 
VS.X-17 
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w 

WH0pen>96 
WIN_CHILD  パ 6 
WinSelect  .x>l83 
WinThief  .x>203 
W し 203.1 NS,  W し 203 .し B-182 
WordMaker  .X>191 
Workroom  >25.  27, 111 
Workroom  SX-68K-19 
Workspace.  x>  183 

X 

X-logo .SMD,  Life .SMD,  Swarm . SMD  ► 
177 

X68000  C  COMPILER  PRO-68K-20 

Xbmp .  X  ► 189 

XC-20 

XC ライブラリ -24 
xemacs  .x(inule)  ►izs 
xstart  .h>l3l 
xstart_hu.h^l31 
xstart_sx.h>l3l 
xt  ar  ante  .X  >174 

z 

Zeitor  .x>l75 

ァ 

アイコ ン 間隔 .r^isi 
アイ ドル イベント  >13 
アク ティべー トイ ベント ► 14 
アセンブラ マクロ ファイル ►巧ァ 
圧縮  >97 

アップ デ ー トイ ベント ►lA 
アニメー シヨ ン 動画 ►lOA 
アニメー シヨ ン ポート  >104 


イベント  >13 
イ ベン ト 駆動 型  >9 


イ ベン ト 駆動 型 マルチ タスク  >4,  5 
イ ン クルー ド ヘッダ  >75 
印刷 中は 演奏 停止. r/mz.x/opm じ .x/ 
cni64r  eveb .  sxb  ► 191 
イ ンス トーラ 丄6バ9 
イ ンス トーラ .X^g 
インライン 展開- 113 

て 

越後 屋残量 .x> 196 

才 

オプション -22 

力 

階層 ウイン ドウ  >94 
階 盾化メ ニュ ー . X  ►181 
階屠メ ニュー  >77 
開発 環 巧* 18 
画像 フォー マット  >97 
カップ めん 194 
壁紙 動画 187 
画面 コ ピ ー .X>195 
環境 变数 バッファ- 164 
環境を 数べ クタ バッファ- 164 

キ 

キ ー アップ イベント  >14 
記憶 クラスの 違い- 141 
疑似 マルチ タスク- 4,  5 
キー ダウン イベント  >14 

ク 

グラフィック ウイン ドウ  >92 
グラフ メニュー .X>172 
クリック ノート .X-194 

=1 

コモン エリ ア  >168 


571 


こんな もの ポイだ •  r  >196 

コンピュータ 画面 . r  ► 192 

ッ 

シ 

追 補 版- 25.26 

地上げ屋 .X  >180 
自己 含き 換え  >11 
システム イベント .-15 

システム イ ベン トコード  >15 

実巧フ ァイ ルの 検索  >68 
実行 ファイルの 構造- 159 
シヤ ー ペン . X  ►IB 

テキス トセ クシ ョ ン  >147 

デー タ セクション ► 147, 162 

デー タ 間引 .X-l?! 

電卓 管理 .r  ►igs 

h 

小 時計. r/ 極小 時計 . r / ト ケイ. r/ 

CLK.r/CK.r-174 
伸張  >97 
新 パスを .X-197 

と けい .X  >174 

ト ランプ 

ナ 

ス 

名前 変更 .x>^ 198 

数値 演寡 .X* 195 
スケル ト ン  >80 

スタック エリア  >164 

スタ ッ クオー バー フロー  ► 164 

スタック セクション  >  163 
スター ト アップ ►  ；159 
スター ト アップルー チン  >166 

ヌ 

める める .X>197 

八 

ミ 凡 用 トレイ .X  >196 

セ 

ヒ 

セク ショ ン  >23. 162 

引数  >116 
引数べ クタ- 166 

ソ 

ビジュアル シェル  >17 

非線形 近似. X- 172 

相対 セク ショ ン  >23, 161 

ビデオ マネー ジャ -98 

夕 

ビデオ マン 関係の マクロ  ►巧6 
ヒ ープェ リァ  >165 

タイム スケール  >108 

タイム スライ シング 型 マルチ タスク-4 •  5 
タグ ジャンプ  >114 

タスク  >4. 10 

タスク 間 通信- 95 
単 方向 リスト  >151 

ヒープ 管理- 150 
ヒープ 処理 関数  >129 
ヒープ 領域  >130. 150 
ヒ ー プ 領域の 構造 ► 150 

フ 

ファイル モ — ド ► 104 

ファ イ ル 名 補完 . X  ► 180 

572 

負荷 計測 SX.X>174 
プロセス 管理 ポインタ- 168 

モジ ユー ルタ イプ ►149. 168 

モー シヨ ン *108 

文字列 お 索 .X>^ 197 

へ 

3 

壁 動 玉々 .r-187 

7 

予約語 1^115 

マイ ン スイ ー パ. X  >186 
マウス アップ イベント  >14 
マウス ダウン イベント  >14 
マ タ □  >155 

麻雀 牌. LB>176 
麻雀 牌 mini  •  LB  ► 176 
マップ エディ タ ぶ>178 
窓を 動かす 2.X>203 

窓を 後へ •！*/ 窓を 前へ •！•/ 窓を 操る .r バ 〇3 
マネー ジャパ 

マルチ タスク 処理  >4 
マルチ プロ グラミ ング方 ま  >10 

ライブラリ 内部を 数- 159, 168 
ライブラリ ファイル -76 

U 

リエン ト ラン ト 可能 >11 
リエント ラントな プログラム  >128 
リスト ファイル >140 

り ソース  >85 

レ 

乂 

レジスタ 相対 ア ドレッシング >11 

目玉 

メディア ID>108 
メモリ 管理 ポインタ- 168 
メモリ マップ >159. 162 

メモリ  メーター . X  ► 173 

メモリ モード ► 104 
面 グラフ .X、 3D 円グラフ 

□ 

ロング ワー ド サイズ >116 

ワーク エリァ  >166 

ワー ド サイズ  >116 

モ 

モジュール ID>100 

SX-WINDOW  ver.3.1 開発 キット 

•  1995 年 8 巧 8 日 初版 第 1 刷 発行 

よしざわ まさとし  うし じ またけ お  にし だ ふみひこ  おば ま じ ゅ A 

•  著者 吉 沢正敏 •牛 島 健 雄 •西 田文彥 •小 浜 純 
参  発 巧者 橋 本 五郎 

参  発行所 ソフトバンク 株式会社 出版 事業部 
参  干 103  東京都 中央 区 日 本 橋 浜 町 3-42-3 

•  販売  03  (5642)  8101 

•  編集  03  (5642)  8140 

•  装 T 勝 侯 正 希 
参  表紙 画 江 口修平 

•  印刷所 東京 書籍 印刷 株式会社 
参  Printed  in  Japan  1995. 

参  ISBN4-89052-748-6  C0055 


落下、 乱 T 本は 小社 販売 局 じて お取り替え 致します。 
を 価は 表紙に 表示して あり ます。 


郵便は 力 《き 


料金 受取人 私  103-00 

161 

東京都 中央 区 

日 本 橋 浜 町 3- 42  -  3 

ソフトバンク 株式会社 出版 事業部 
ハー ドウて ア 活用 書 編集部 行 


日本 橋 局 
承認 

1277 


差 出 有効期間 
平成 8 年 4 巧 
30 日まで 


を 巧 巧 

巧 

名 

年 

齢 

性 

別 

男 

女 

職業- 勤務先 
学校 (学部）. 学年 

肺 機種 

■し义 下の 質問に お答え 下さい 

内容  1. わかりやすい 

装 T  1. よし、 

価 お  1. 高い 

CD-ROM ドライブ 

通信  1. している 


ふつ ラ 
ふつ ラ 
ふつ ラ 
持つ でし、 る 
していない 


3. わかりにくし、 
3. わるい 
3. 安い 

2. 持って いなし、 
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3.  書店で 見て  4. 書店で すすめられて 

日. その他 （  ） 

■この 本を お 買 上げの 書店る は？ 

都 •道 
府 •県 


己. 人に すすめられて 


区 •市  書店 


2  〇一 2 1  CU 


■今後 どのよ うな 企画を わ 望みです か？ 
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